Package Data | |
---|---|
Maintainer Username: | JVMartin |
Maintainer Contact: | jacobm@angelvisiontech.com (Jacob Martin) |
Package Create Date: | 2014-06-11 |
Package Last Update: | 2016-08-06 |
Home Page: | |
Language: | PHP |
License: | Unknown |
Last Refreshed: | 2024-11-22 03:13:40 |
Package Statistics | |
---|---|
Total Downloads: | 824 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 45 |
Total Watchers: | 14 |
Total Forks: | 9 |
Total Open Issues: | 2 |
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:
app/routes.php
.csrf
filter in app/filters.php
.app/controllers
except BaseController.php
.app/models
, including User.php
. You can replace it with a .gitkeep
file for now to be sure to keep the app/models
directory.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');
});