Amila Laravel CMS
- 免费,开源简单的简单引导Laravel CMS ,支持Laravel 8.x或7.x或旧Laravel 6.x&5.x,支持mysql&Mariadb&PostgreSQL
- 可以与任何现有的Laravel项目集成,作为单独的Laravel软件包安装
- 仅添加一些带有前缀的数据库表,而不会影响您现有的数据库表。
- 您可以轻松自定义数据库表名称,页面URL路径(路由)和模板(主题)
- 安装后,Build-In网站已准备就绪。易于使用,足够简单但灵活。
- 基本Laravel 8.x / laravel 7.x / laravel 6.x / laravel 5.x语法和刀片模板,无需学习“新语言”
如何为现有的Laravel项目安装
- 支持Laravel 8.X和Laravel 7.x和Laravel 6.x和Laravel 5.x
// Make sure you already have laravel installed and configured the database in the .env // Go to your laravel project folder and install it via composer // Initialize the CMS (You can set up database table prefix and locale here) composer require alexstack/laravel-cms && php artisan laravelcms // Now you can access the cms frontend site: http://your*doma**in/cms-home // Access the backend with the FIRST USER of your site: http://yourdom*ai**n/cmsadmin // Note: The default admin is the first user in your laravel database(user id = 1 )
如何使用最新的Laravel建立全新的CMS网站
- 这是对当地测试的好方法,它支持最新的Laravel版本
Laravel CMS && cd cms && composer require alexstack/laravel-cms
// Step 2: install CMS in silent mode
php artisan laravelcms –locale=en –table_prefix=cms_ –silent=yes
// Note: it will ask for database settings if you did not change the default .env file
// Note: it will automatically run a web server on port 9321 for your project
// Step 3: Now, you can access your cms backend via http://127.***0.0.1:9321/cmsadmin/
// Default admin username: admin@admin.com password: admin321
\”>
// Step 1: Install Laravel to folder cms composer create-project laravel/ Laravel CMS && cd cms && composer require alexstack/laravel-cms // Step 2: install CMS in silent mode php artisan laravelcms --locale=en --table_prefix=cms_ --silent=yes // Note: it will ask for database settings if you did not change the default .env file // Note: it will automatically run a web server on port 9321 for your project // Step 3: Now, you can access your cms backend via http://127.***0.0.1:9321/cmsadmin/ // Default admin username: admin@admin.com password: admin321
如何卸载
// Uninstall the CMS
php artisan laravelcms --action=uninstall
演示和文档
- Laravel CMS前端演示和文档?
安装命令输出的屏幕截图
卸载命令输出的屏幕截图
管理面板的屏幕截图
将语言语言语言设置为CN而不是EN
访问后端 /cmsadmin /
- 这意味着您没有安装Laravel Auth(用户系统)
- 可以通过以下命令修复:
// Laravel 6.x & Laravel >= 7 & Laravel >= 8 composer require laravel/ui && php artisan ui vue --auth // Laravel 5.x, run blow command instead php artisan make:auth && php artisan migrate
- 安装验证包后,请注册第一个用户为管理员
如何登录后端 /cmsadmin /?
- Amila CMS使用您现有的Laravel用户系统
- 您需要与网站的第一个用户登录(user_id = 1)
- 您可以通过更改config/laravel-cms.php中的admin_ary添加更多管理用户
- 如果您没有任何现有用户,请通过http:// your-domain/nopers注册新用户
为什么上传的图像无法显示(404错误)
- 您可以通过创建存储公共链接来解决它
- PHP工匠存储:链接
- 例如。公共/存储应链接到../storage/app/public,如果公共/存储是一个真正的文件夹,则应将其删除/重命名并运行“ PHP Artisan Storage:link:link”以设置链接。
自定义config/laravel-cms.php中的CMS路由
- HOMEPAGE_ROUTE :这是前端主页。默认情况下它是 / cms-home,您可以将其更改为 /然后在路由 / web.php中删除现有 /路由
# Change homepage_route to / in config/laravel-cms.php \' homepage_route \' => env ( \' LARAVEL_CMS_HOMEPAGE_ROUTE \' , \' / \' ), # Remove the existing / route in the routes/web.php // Route::get(\'/\', function () { // return view(\'welcome\'); // });
- page_route_prefix :这是前端页面前缀。默认情况下它是 /cms-,它将匹配 /cms-*的路径。您可以将其更改为 / xxx /之类的文件夹或xxx-之类的内容,例如。页面 – 文章 –
\' page_route_prefix \' => env ( \' LARAVEL_CMS_PAGE_PREFIX \' , \' /Article- \' ),
- Admin_Route :这是后端管理页面路由,默认情况下是 /cmsadmin
\' admin_route \' => env ( \' LARAVEL_CMS_BACKEND_ROUTE \' , \' /admin2019 \' ),
- 更改路线后,您将需要在下面运行:
php artisan laravelcms --action=clear
在前端laravel .blade.php模板文件中显示具有不同大小的图像
- .blade.php代码示例:
@ if ( isset ( $ file_data -> main_image ) ) <img src=\"{{ $ helper -> imageUrl ( $ file_data -> main_image , \' 1000 \' ) }}\" class = \" img-fluid \" /> <img src= \" { { $ helper -> imageUrl ( $ file_data -> main_image , \' 500 \' ) } } \" class= \" img-fluid \" /> <img src= \" { { $ helper -> imageUrl ( $ file_data -> main_image , \' w \' , \' 150 \' ) } } \" class= \" img-fluid \" /> <img src= \" { { $ helper -> imageUrl ( $ file_data -> main_image , \' 100 \' , \' 100 \' ) } } \" class= \" img-fluid \" /> <img src= \" { { $ helper -> imageUrl ( $ file_data -> main_image , \' original \' , \' original \' ) } } \" class= \" img-fluid \" /> @endif
- 您可以获得任何宽度和高度的图像。或使用原始图像。
- 可用图像变量:$ file_data-> main_image,$ file_data-> main_banner,$ file_data-> extra_image,$ file_data-> file_data-> extra_image_2
- CMS将首次调整图像大小,然后将其直接使用。
如何更改前端的CSS&JS资产?
- 位于public/laravel-cms/<Theme_name>的资产文件,例如。 public/laravel-cms/frontend/css
- 加载CSS或JS的示例代码:
<link rel=\"stylesheet\" href=\"{{ $ helper -> assetUrl ( \' css/main.css \' ) }}\">
. . .
<script src=\"{{ $ helper -> assetUrl ( \' js/bottom.js \' ) }}\"></script>
- 默认模板文件将使用last_modify_time参数加载CSS和JS资产,以避免从浏览器中缓存
如何从默认设置设置不同的模板主题?
- 将默认的主题文件夹/资源/视图/laravel-cms/ frontend复制到/resources/views/laravel-cms/ new_theme
- 将“设置”页面中的frontend_dir更改为new_theme
- config/laravel-cms.php中的默认值
\' template \' => [ \' frontend_dir \' => \' frontend \' , \' backend_dir \' => \' backend \' , \' backend_language \' => \' en \' , \' frontend_language \' => \' en \' , ]
- 运行PHP Artisan配置:缓存加载新配置文件
- 更改后端中页面的模板设置
- CSS/JS资产文件将位于public/laravel-cms/ new_theme
在config/laravel-cms.php中设置默认的slug格式和后缀SEO URL
- 您可以在设置页面上更改它
- \’slug_format\’可以来自_title,id,pinyin
- “ slug_suffix”可以是您想要的任何东西,空意味着没有后缀
\' slug_format \' => \' from_title \' , \' slug_suffix \' => \' .html \' , \' slug_separate \' => \' - \' ,
使用您自己的PHP类 /如何将PHP代码集成到CMS
- 一个简单的选择是通过将其添加到CMS页面中,从您自己的PHP控制器/类实现方法。教程。
- 另一个选择是为您自己的项目创建CMS插件,并将其用于所有页面。教程在这里。如果其他网站可以使用该功能,则也可以发布该插件。
如何升级CMS?
- 在您的Laravel项目文件夹中运行以下命令
- 它将询问您是否要将新视图,资产和语言文件复制到项目
composer require alexstack/laravel-cms && php artisan laravelcms --action=upgrade
- 升级屏幕快照
后端所有页面列表的ReactJ
- Laravel CMS使用ReactJ用于后端所有页面列表,ReactJS源代码可以在此处找到
- 编译的JS文件在这里:/public/laravel-cms/backend/js/reaectlaravelcmsbackend.js
- 它可以通过更改“ react_js”切换到普通的laravel刀片页面:在设置system.all_pages中为false。
您支持哪些PHP版本?
- Amila Laravel CMS通过了PHP 7.1、7.2、7.3、7.4的基本测试。
Laravel版本支持
- CMS版本> = 1.4.4,支持所有Laravel版本> = 6.0
- CMS版本<= 1.4.3:支持Laravel 5.x,6.x,7.x,8.x
- 如果Laravel版本是现有项目的5.x,请安装版本1.4.3
如何使用PostgreSQL代替MySQL或MariadB?
- 在运行安装命令行之前,请确保.env更改。一个例子:
DB_CONNECTION =pgsql DB_HOST =topsy.db.elephantsql.com DB_PORT = 5432 DB_DATABASE =oktetra DB_USERNAME =oktetra DB_PASSWORD =the-postgresql-password
如何在AWS S3上存储和访问文件?
-
在AWS上:创建一个S3存储桶并将其启用为静态网站托管,允许所有公共访问权限并设置S3:GetObject Bucket策略,创建IAM用户以供API使用。
-
laravel .env文件,设置下方的变量:
AWS_ACCESS_KEY_ID = AWS_SECRET_ACCESS_KEY = AWS_DEFAULT_REGION = AWS_BUCKET = FILESYSTEM_DRIVER =s3 AWS_URL =
-
作曲家需要联盟/flysystem-aws-s3-v3 ^1.0
-
完毕
如何安装Laravel/Jetstream或其他UI而不是Laravel/UI?
Laravel CMSjet && cd cmsjet && composer require laravel/jetstream
// Step 2: install jetstream
php artisan jetstream:install inertia && npm install && npm run dev
// Step 3: install CMS in silent mode
composer require alexstack/laravel-cms && php artisan laravelcms –locale=en –table_prefix=jet_ –silent=yes
// Step 4: Edit routes/web.php
– Remove or comment Auth::routes();
– Change Route::get(\’/\’ to Route::get(\’/welcome\’
– Run command: php artisan laravelcms –action=clear
// Step 5: Now, you can access your cms backend via http://127.***0.0.1:9321/cmsadmin/
// Default admin username: admin@admin.com password: admin321
\”>
// Step 1: Install Laravel to folder cms composer create-project laravel/ Laravel CMS jet && cd cmsjet && composer require laravel/jetstream // Step 2: install jetstream php artisan jetstream:install inertia && npm install && npm run dev // Step 3: install CMS in silent mode composer require alexstack/laravel-cms && php artisan laravelcms --locale=en --table_prefix=jet_ --silent=yes // Step 4: Edit routes/web.php - Remove or comment Auth:: routes (); - Change Route::get( \' / \' to Route::get( \' /welcome \' - Run command: php artisan laravelcms --action=clear // Step 5: Now, you can access your cms backend via http://127.***0.0.1:9321/cmsadmin/ // Default admin username: admin@admin.com password: admin321
如何在Heroku上安装?
- 本地:首先,在您的本地主机上安装,确保一切正常
- 本地:为LaravelCMS文件夹创建一个GitHub存储库。例如。 CD CMS && git Init && git Remote添加https://gith*u**b.com/xxx.git
- 本地:启用Heroku php的GD Exif:作曲家需要Ext-Exef Ext-GD
- 在Heroku上:从此GitHub存储库创建一个新应用程序,启用自动部署
- 本地:要将NGINX/APACHE与PHP一起使用,请在文件夹CMS上添加一个名为Procfile的文件,其中包括以下内容:
web: vendor/bin/heroku-php-apache2 public/
- Heroku:添加Dyno编队:Web/bin/heroku-php-apache2 public/
- Heroku:添加.ENV变量到设置 – >配置vars
- 完毕
执照
- Amila Laravel CMS是根据MIT许可证许可的开源软件。
