Download the PHP package agence-adeliom/easy-page-bundle without Composer

Easy Page Bundle

A basic CMS system for Easyadmin.

Installation with Symfony Flex

Add our recipes endpoint

Install with composer

Versions

Setup database

Using doctrine migrations

Without

Documentation

Manage pages in your Easyadmin dashboard

Go to your dashboard controller, example : src/Controller/Admin/DashboardController.php

View page

The PageController handles some methods to view pages with a single index().

The URI for both is simply /{slug} where slug is the... page.

If your page has one parent, then the URI is the following: /{parentSlug}/{slug}.

You can notice that we respect the pages hierarchy in the generated url.

You can navigate through a complex list of pages, as long as they are related as parent and child.

This allows you to have such urls like this one : http://www.mysite.com/about/company/team/members for instance, will show only the members page, but its parent has a parent, that has a parent, and so on, until you reach the "root" parent. And it's the same behavior for categories.

Note: this behavior is the precise reason why you have to use a specific rules for your routing, unless you may have many "404" errors.

Generate a route based on a single page

If you have a Page object in a view or in a controller, you can get the whole arborescence by using the getTree() method, which will navigate through all parents and return a string based on a separator argument (default /, for urls).

Let's get an example with this kind of tree:

Imagine we want to generate the url for the "Team" page. You have this Page object in your view/controller.

Or in a controller:

Homepage

The homepage is always the first Page object with its template attribute set to homepage. Be sure to have only one element defined as homepage, or you may have unexpected results.

Design

You have some options to customize the design of your simple CMS.

Using different layouts

Obviously, the default layout has no style.

To change the layout, simply change the OrbitaleCmsBundle configuration to add your own layout:

Without overriding anything, you can easily change the layout for your CMS!

Take a look at the default layout to see which Twig blocks are mandatory to render correctly the pages.

Advanced layout configuration

The basic configuration for a layout is to specify a template to extend.

But if you look at the Configuration reference you will see that there are many other parameters you can use to define a layout:

Prototype of a layout configuration:

• name (attribute used as key for the layouts list):
  The name of your layout. Simply for readability issues, and maybe to get it directly from the config (if you need it).
• resource:
  The Twig template used to render all the pages (see the above section)
• assets_css and assets_js:
  Any asset to send to the Twig asset() function. The CSS is rendered in the stylesheets block, and js in the javascripts block.
• host:
  The exact domain name you want the layout to match with.
• pattern:
  The regexp of the path you want to match with for this layout. It's nice if you want to use a different layout for pages. For example, you can specify a layout for the ^/page/ pattern, and another for ^/about-us/. If you specify a very deep pattern, you can even change the layout for a single page!

Take another look on the config reference if you need to get the prototype defaults.

:warning: Warning! The first matching layout will be used, as well as routing would do, so be sure to configure them in the right order!
Empty values won't be taken in account.

Configuration reference

License

MIT

Authors

• @arnaud-ritti

Thanks to

Orbitale/CmsBundle