Rinvex Pages is an integral part for your Laravel content management system (CMS), it affords an easy, yet powerful way to create and manage pages with full control over their URLs, active status, titles, content, and other attributes.
-
Install the package via composer:
composer require rinvex/laravel-pages
-
Publish resources (migrations and config files):
php artisan rinvex:publish:pages
-
Execute migrations via the following command:
php artisan rinvex:migrate:pages
-
Done!
To get started, you simply create a new page as follows:
$page = app('rinvex.pages.page')->create([
'uri' => 'test',
'slug' => 'test-page',
'route' => 'frontend.pages.test',
'title' => 'Test Page',
'view' => 'test-page',
]);
// Deactivate the page
$page->deactivate();
// Activate the page
$page->activate();
// Get all pages
$pages = app('rinvex.pages.page')->all();
// Get active pages
$pages = app('rinvex.pages.page')->where('is_active', true)->get();Notes:
- All active pages are registered automatically into your application router with page's attributes, so the example page we created above could be accessed via the URL
http://your-project/test, and you can generate page's URL using the named routeroute('frontend.pages.test')as you may expect. The result of accessing that page is the content of the page's rendered view.- Rinvex Pages auto register routes for your active pages, but you can disable routes auto registration in case you need more flexibility writing your own routes and maybe linking to your custom controllers, and that could be done from the config file
config/rinvex.pages.phpif you already published it in the installation step.- Rinvex Pages expects you to create your own views before setting in page records, and that view could be anywhere and contain anything. It's important to know that all page views have access to the
$pageinstance variable by default, so you can access any of the page's attributes.
Sometimes you need to attach other resources to a specific page, to display later as "Related Content" for example, the presentation layer is left to you to implement, but the following is how to attach these resources programmatically.
To attach other resources to any page, follow these two steps:
-
Use
\Rinvex\Pages\Traits\Pageabletrait in your resources you need to attach. -
Register your resource as a
pageable, and add mutator setter/getter support for in your resource in the page's model. This is done in service providerbootmethod. See the following example ofArticleresource we're attaching to the page:
use App\Models\Article;
use Illuminate\Database\Eloquent\Relations\MorphToMany;
app('rinvex.pages.pageables')->put('article', Article::class);
app('rinvex.pages.page')->macro('setArticlesAttribute', function ($articles) {
static::saved(function (self $model) use ($articles) {
$model->entries(Article::class)->sync($articles, true);
});
});
app('rinvex.pages.page')->resolveRelationUsing('articles', function ($pageModel): MorphToMany {
return $pageModel->entries(Article::class);
});Refer to the Changelog for a full history of the project.
The following support channels are available at your fingertips:
Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.
Bug reports, feature requests, and pull requests are very welcome.
If you discover a security vulnerability within this project, please send an e-mail to [email protected]. All security vulnerabilities will be promptly contacted.
Rinvex is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Alexandria, Egypt since June 2016. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. That’s how we do our share of advancing humanity.
This software is released under The MIT License (MIT).
(c) 2016-2022 Rinvex LLC, Some rights reserved.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent