Download the PHP package regulus/fractal without Composer
On this page you can find all versions of the php package regulus/fractal. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package fractal
Fractal
A versatile CMS for Laravel 5.
Note: For Laravel 4, you may use version 0.8.2.
Fractal is a content management system for Laravel which maintains freedom and easy access to customization, to a range of different degrees. You can do all of this out of the box:
- Manage content pages for website
- Create as many separate content areas as you like and create content in Markdown or an HTML WYSIWYG editor
- Use the layout template system to re-use standardized and custom layouts across pages
- Re-use content areas across multiple pages
- Manage files
- Upload files
- Resize images
- Create thumbnail images
- Manage blog articles
- Make use of the same versatile content area system as content pages uses
- Manage media items (images, video, audio, and more...)
- Manage website / web application settings
- Manage all menus via database, for both front-end website (optional of course) and admin/CMS area
- Manage users
- Customize routes, controllers, and subdomains (by default, "blog" and "media" subdomains are used)
- Use built-in front-end views and Blade layouts or use your own
Please keep in mind though that there are a variety of different levels of customization available from using all or a partial set of custom controllers (Fractal's controller and method routes are set in config.php
for easy modification), using custom views, or even just customizing any of the many available config settings or database-stored settings in the CMS' Settings page. The level of control of your website or web application that you wish to externalize from Fractal is entirely up to you.
A couple more things that should be mentioned before we get started with the Table of Contents:
- Fractal uses the Identify authorization / authentication package and uses Twitter Bootstrap 3 as its CSS framework.
- You may view Fractal on Trello to see what's on the bug fixing and feature implementation roadmap.
Table of Contents
- Installation
- Installation: Authentication
- First Log In
- Basic Usage
Installation
Install composer package:
To install Fractal, make sure "regulus/fractal" has been added to Laravel 5's composer.json
file.
"require": {
"regulus/fractal": "0.9.*"
},
Then run php composer.phar update
from the command line. Composer will install the Fractal package.
Register service provider and set up alias:
Now, all you have to do is register the service provider, set up Fractal's alias in config/app.php
, publish the assets, and run the install command. Add this to the providers
array:
Regulus\Fractal\FractalServiceProvider::class,
And add this to the aliases
array:
'Fractal' => Regulus\Fractal\Facade::class,
Add middleware to the routeMiddleware
array in app/Http/Kernal.php
:
'auth.permissions' => \Regulus\Identify\Middleware\Authorize::class,
'auth.fractal' => \Regulus\Fractal\Middleware\Authenticate::class,
Add and run the install command:
Add the following to the commands
array in app/Console/Kernel.php
:
\Regulus\Identify\Commands\Install::class,
\Regulus\Identify\Commands\CreateUser::class,
\Regulus\Fractal\Commands\Install::class,
Set the sessions domain:
Set the domain
variable in config/sessions.php
to ensure that session data is carried across subdomains:
'domain' => '.website.com',
Then run the following command:
php artisan fractal:install
Fractal (along with Identify) will now be installed. This includes all necessary DB migrations, DB seeding, config publishing, and asset publishing.
The config file that is published for Identify is auth.php
and will overwrite Laravel 5's default auth configuration. The default table names are prefixed with auth_
, but you may alter the users table name by adding a --user-tables-prefix
option to the install line:
php artisan fractal:install --user-tables-prefix=none
php artisan fractal:install --user-tables-prefix=identify
The former example will remove the prefix from all of the table names, so you will get users
, roles
, etc. The latter example will change the default table prefix of auth
to identify
so your table names will be identify_users
, identify_roles
, etc.
You should now have 4 users, Admin
, TestUser
, TestUser2
, and TestUser3
. All of the default passwords are simply password
and the usernames are case insensitive, so you may simply type admin
and password
to log in. The 3 initial roles are Administrator
, Moderator
, and Member
. Admin
has the Administrator
role, TestUser
has the Moderator
role, and the final 2 users have the Member
role.
The install command will also attempt to automatically add a singleton to bootstrap/app.php
which swaps out Laravel's default LoadConfiguration
class to allow delaying the loading of certain config files until after Fractal's service provider runs. If the install command is not able to add the singleton, go into bootstrap/app.php
and add this after the other singletons under the "Bind Important Interfaces" heading:
$app->singleton(
Illuminate\Foundation\Bootstrap\LoadConfiguration::class,
Regulus\Fractal\Libraries\LoadConfiguration::class
);
Installation for Authentication
Install Composer package:
To install Identify, make sure "regulus/identify" has been added to Laravel 5's composer.json
file.
"require": {
"regulus/identify": "dev-master"
},
Then run php composer.phar update
from the command line. Composer will install the Identify package.
Register service provider and set up alias:
Add this to the providers
array in config/app.php
:
'Regulus\Identify\IdentifyServiceProvider',
First Log In
Logging in:
To log in, go to website.com/admin
where "website.com" is the name of the site you have installed Fractal on. Type "Admin" and "password" as your username and password and click "Log In".
You should now be logged in to Fractal for the first time. You should now be able to manage the CMS and the settings of the website or web application.
Enabling Developer Mode:
To set a developer
session variable to true
, go to website.com/admin/developer
. This will identify you as the web developer for Fractal and you may be able to see more information and manage extra settings. To turn off Developer Mode, go to website.com/admin/developer/off
.
Basic Usage
Adjusting Fractal's base URI:
By default, Fractal's base URI is admin
making your URLs like website.com/admin/pages/home/edit
. You may adjust this in the base_uri
variable in config.php
.
Adding additional controllers:
You may add additional controllers or point existing defined controllers to alternates in the controllers
array in config.php
. Use standard
for standard Laravel controllers and resource
for resource controllers.
Other configuration options:
Look around in the various config files such as config
, blogs
, media
, tables
, and social
to see what other configuration options can easily be customized as well. Most config variables have detailed descriptions that should help you to understand how different things can be customized. The config files menus
and settings
, however, are exported from the database automatically to minimize a Fractal-driven website's need to make certain database queries on each page load.
Get Bootstrap-ready menu markup for a view:
echo Fractal::getMenuMarkup(); //get "Main" menu markup
echo Fractal::getMenuMarkup('Footer'); //get "Footer" menu markup
echo Fractal::getMenuMarkup('Footer', ['class' => 'nav nav-pills']); //set class attribute for menu
Getting an array of menu items:
$menu = Fractal::getMenuArray(); //get "Main" menu array
$menu = Fractal::getMenuArray('Footer'); //get "Footer" menu array
Setting a page title:
Fractal already uses SolidSite to handle page titles, breadcrumb trails, and some other things which means that if you are using Fractal's public layout for your website, you may set page titles using the following code.
//title HTML tag may look like "A Page Title :: Website.com" depending on config
Site::set('title', 'A Page Title');
//this can be used to differentiate the title that actually appears on the page from the primary title
Site::set('titleHeading', 'Alternate Title in Content');
//you may show the title using these
echo Site::title();
echo Site::titleHeading(); //will use "titleHeading" if it is set and if not will default to "title"
All versions of fractal with dependencies
laravel/framework Version 5.*
regulus/activity-log Version 0.5.*
regulus/elemental Version 0.5.*
regulus/formation Version 1.0.*
regulus/identify Version 0.8.*
regulus/solid-site Version 0.6.*
regulus/tetra-text Version 0.5.*
regulus/upstream Version 0.5.*
alfredo-ramos/parsedown-extra-laravel Version ~0.2