Angel is a CMS built on top of Laravel. It is available via Packagist.
UPDATE 8/5/2016: The Laravel 5 version of Angel is underway here.
UPDATE 3/9/2015: Just wanted to give a heads up that this project is still in very active usage and deployment and is well tested by several large applications. The eCommerce module that works with Stripe is also well tested and used.
The Angel CMS was built on top of Laravel 4.1.
Install Laravel 4.1 using the following command:
composer create-project laravel/laravel --prefer-dist {project-name} 4.1.*Add the angel/core package requirement to your composer.json file, like this:
"require": {
"laravel/framework": "4.1.*",
"angel/core": "1.0.*"
},Issue a composer update to install the package.
After the package has been installed, open app/config/app.php and add the following to your providers array:
'Angel\Core\CoreServiceProvider'While you're in there, set debug to true.
Delete:
- All the default routes in
app/routes.php. - All the default filters except for the
csrffilter inapp/filters.php. - All controllers in
app/controllersexceptBaseController.php. - All the models in
app/models, includingUser.php. You can replace it with a.gitkeepfile for now to be sure to keep theapp/modelsdirectory.
Create and configure your database so that we can run the migrations.
Finally, issue the following artisan commands:
php artisan dump-autoload # Dump a load
php artisan asset:publish # Publish the assets
php artisan config:publish angel/core # Publish the config
php artisan migrate --package=angel/core # Run the migrations
mkdir -p public/uploads/kcfinder # Create the KCFinder uploads folder
touch public/uploads/kcfinder/.gitkeep # Keep the folder
Every class in the core is easily extendable.
Let's start by extending the PageController.
When extending this controller, you can create a method for each page URI that you've created in the administration panel.
Create the following file as app/controllers/PageController.php:
<?php
class PageController extends \Angel\Core\PageController {
public function home()
{
return 'You are home!';
}
}Remove the old binding and bind your new class at the top of your routes.php file:
App::offsetUnset('PageController');
App::singleton('PageController', function() {
return new \PageController;
});
Do a composer dump-autoload.
Now, you should be able to navigate to http://yoursite.com/home and see: You are home!.
Take a look at the config file you just published in app/config/packages/angel/core/config.php.
By default, the following configuration is set:
'admin_prefix' => 'admin'
This allows one to access the administration panel via the url http://yoursite.com/admin.
To be secure, you may want to change this prefix. Hackers tend to target sites with URLs like this.
The next section is the 'menu' array. When you install modules, you add their indexes to this array so that they appear in the administration panel's menu.
Some modules come with models that you can create menu links to in the Menu module. This array is used by the Menu Link Creation Wizard on the Menu module's index.
Often times, you will want to let users access products, blog posts, news articles, etc. by name instead of by ID in the URL.
For instance: http://yoursite.com/products/big-orange-ball.
To do this, you want to 'sluggify' one of the columns / properties of the model.
If you are extending the AngelModel, this is as simple as adding a slug column to your table with a unique index:
$table->string('slug')->unique();And then setting the slugSeed property of your model to the name of the column from which to generate the slug:
protected $slugSeed = 'name';Now, slugs will be automatically generated from the name column of the models as they are created or edited. (You can just as easily use a title column or any other appropriate source.)
You can use the generated slugs after adding or editing some items.
For instance:
// app/routes.php
Route::get('products/{slug}', 'ProductController@view');
// app/controllers/ProductController.php
class ProductController extends \Angel\Core\AngelController {
public function view($slug)
{
$Product = App::make('Product');
$this->data['product'] = $Product::where('slug', $slug)->firstOrFail();
return View::make('products.view', $this->data);
}
}// Adding a new item:
$article = new NewsArticle;
$article->title = Input::get('title');
$article->slug = slug($article, 'title');
$article->save();
// Editing an item:
$article = Article::find(1);
$article->title = Input::get('title');
$article->slug = slug($article, 'title');
$article->save();$slug = sluggify('String to sluggify!'); // Returns 'string-to-sluggify'Here is where we'll put code snippets for developing modules.
Assume we're developing a persons module package.
First, make sure that Person extends \Angel\Core\AngelModel and has the property protected $reorderable = true;.
// workbench/persons/src/views/admin/persons/index.blade.php
@section('js')
{{ HTML::script('packages/angel/core/js/jquery/jquery-ui.min.js') }}
<script>
$(function() {
$('tbody').sortable(sortObj);
});
</script>
@stop
@section('content')
<table class="table table-striped">
<tbody data-url="persons/order"><!-- This data-url is appended to the admin url and posted. -->
@foreach ($persons as $person)
<tr data-id="{{ $person->id }}">
{{ Form::hidden(null, $person->order, array('class'=>'orderInput')) }}
<button type="button" class="btn btn-xs btn-default handle">
<span class="glyphicon glyphicon-resize-vertical"></span>
</button>
</tr>
@endforeach
</tbody>
</table>
@stop
// workbench/persons/src/routes.php
Route::group(array('prefix' => admin_uri('persons'), 'before' => 'admin'), function() {
Route::post('order', 'AdminPersonsController@order');
});