README

CMSGears 博客模板

CMSGears 博客模板是一个用于开发基于CMSGears的应用程序的骨架，适用于开发利用核心模块（包括核心、表单、CMS、新闻通讯、通知和SNS连接）的CMSGears应用程序。

模板包括四个层级：REST、前端、后端和控制台，每个都是一个独立的Yii应用程序。

该模板设计用于团队开发环境。它支持在不同环境中部署应用程序。

博客模板专为开发小型和中型Web应用程序而设计，支持移动应用程序，无需复杂模块，包括CMS模块、社区模块等。如果您需要不带CMS的起始模板，请查看基本模板。

目录结构

common
    config/              contains shared configurations
    mail/                contains view files for e-mails
    models/              contains model classes used in REST, backend and frontend
    services/            contains shared services used in REST, backend and frontend
    tests/               contains tests for common classes
console
    components/          contains console components
    config/              contains console configurations
    controllers/         contains console controllers (commands)
    migrations/          contains database migrations
    models/              contains console-specific model classes
    runtime/             contains files generated during runtime
    services/            contains console services
backend
    assets/              contains application asset classes
    config/              contains backend configurations
    controllers/         contains Web controller classes
    models/              contains backend-specific model classes
    runtime/             contains files generated during runtime
    services/            contains backend-specific services
    tests/               contains tests for backend application
    views/               contains view files for the Web application
    web/                 contains the entry script and Web resources
frontend
    assets/              contains application asset classes
    config/              contains frontend configurations
    controllers/         contains Web controller classes
    models/              contains frontend-specific model classes
    runtime/             contains files generated during runtime
    services/            contains frontend-specific services
    tests/               contains tests for frontend application
    views/               contains view files for the Web application
    web/                 contains the entry script and Web resources
rest
    config/              contains REST configurations
    controllers/         contains REST controller classes
    models/              contains rest-specific model classes
    runtime/             contains files generated during runtime
    services/            contains rest-specific services
    tests/               contains tests for REST application
    web/                 contains the entry script
modules/    	         contains the project modules
templates/    	         contains the project templates
themes/                  contains the template themes
uploads/    	         contains the uploaded files
widgets/    	         contains the template widgets
environments/            contains environment-based overrides
vendor/                  contains dependent 3rd-party packages

模块、插件和小部件

它预装了核心、表单、CMS、新闻通讯、通知和SNS连接模块。
它预装了资产、Breeze模板、文件管理器、社交元和图标选择器插件。
博客模板默认提供的小部件包括CLEditor、TinyMCE、评论、块、导航、俱乐部、元素、登录、相册、新闻通讯、表单、AJAX表单、标签、类别、社交、弹出窗口和网格。
它还预装了CMSGears的FoxSlider插件。
除了在第1至3点中指定的模块、插件和小部件之外，模板还针对几个第三方资产进行了配置，包括conditionizr、moment、chart.js等。

主题

管理员主题提供布局以管理和配置模块和插件。
模板已预配置，用于前端使用博客主题。

模板详细信息

博客模板是一组用于管理后端、前端、控制台和REST应用程序的目录和配置文件。

它还提供了带有测试数据的迁移脚本。

模板演示

前端 - https://demo.cmsgears.com/templates/blog (demouser@cmsgears.com, test#123)
管理员 - https://demo.cmsgears.com/templates/blog/admin (demomaster@cmsgears.com, test#123)

在演示网站上禁用了实时电子邮件，并且每小时重置数据库。

模板安装

博客模板可以通过composer使用以下命令安装。有关安装composer的信息，请参阅官方网站 https://getcomposer.org.cn。

我们可以使用以下方式使用composer安装发行版和预发布版，即alpha、beta版本。

// Release Versions

php composer.phar create-project --prefer-dist --stability=stable cmsgears/template-blog blogdemo

or

composer create-project --prefer-dist --stability=stable cmsgears/template-blog blogdemo

我们还可以使用以下命令访问预发布代码。

// Pre-release Versions

php composer.phar create-project --prefer-dist --stability=<alpha or beta or RC> cmsgears/template-blog blogdemo

or

composer create-project --prefer-dist --stability=<alpha or beta or RC> cmsgears/template-blog blogdemo

如果Web服务器是Apache，则可以在Apache Web根目录直接运行上述任一命令。更多详细信息可以在 http://www.cmsgears.org 上找到。

我们还可以通过克隆具有最新代码的模板来直接安装模板，使用所选分支。

一键安装

我们正在努力制作一键安装，可以避免大多数以下步骤来配置模板。

模板配置

创建数据库、数据库用户并更新环境配置 - environments/dev/common/config/main-env.php、environments/alpha/common/config/main-env.php、environments/prod/common/config/main-env.php。默认数据库和数据库用户名为basicdemo。
要触发开发或alpha环境中的实时邮件，从以下配置中移除'useFileTransport'配置参数：- environments/dev/common/config/main-env.php，environments/alpha/common/config/main-env.php。
配置数据库后，运行php脚本init.php初始化预定义环境的应用程序。该脚本会要求选择环境，包括prod、alpha或dev。它将相应的环境文件复制到相关目录。
使用console/migrations目录中可用的migrate-up命令安装数据库。必须从项目的根目录运行该命令。同时确保迁移命令文件具有可执行权限。
console/migrations/data目录中提供的迁移脚本包含了演示所需的数据。可以根据需求进行调整或更新。在更改之前，请确保执行migrate-down命令。完成后，再次执行migrate-up命令以应用更改。
根据您的Web服务器需求更新根目录中的htaccess文件。有关实时应用程序设置的更多详细信息，请访问http://www.cmsgears.org。
下载管理员和博客主题，并将主题内容分别复制到/themes/admin和/themes/blog目录。
现在我们可以使用我们喜欢的浏览器运行模板。以下是一些示例链接。
登录到管理员并更新文件上传URL，如果项目名称或上传目录不同。
默认情况下，所有用户上传的文件都将存储在uploads目录中。根据项目需求，可以更改uploads目录。
如有需要，更新迁移脚本，并运行migrate-down和migrate-up命令刷新数据库。请确保仅在dev和alpha环境中执行。绝对不要在生产环境中运行migrate-down，否则将删除所有实时数据。

默认应用程序URL如下。如果已更改，请将blogdemo替换为项目名称。

Frontend - http://localhost/blogdemo/frontend/web
Admin - http://localhost/blogdemo/frontend/web

模板 - 更新

可以使用位于模板根目录的composer.json文件更新模板依赖项。

模板页面

模板附带以下预配置页面。

着陆页 - 网站索引页。
登录 - 登录页允许用户登录。
注册 - 注册页允许用户注册。
确认账户 - 用户可以通过在提交注册表单时发送到他们电子邮件中的链接来确认账户。
忘记密码 - 可以用来生成密码重置链接。
忘记密码OTP - 可以用来生成用于重置密码的OTP。如果提供了SMS管理器，则它将工作。
重置密码 - 用户可以通过在提交忘记密码表单时发送到他们电子邮件中的链接来重置密码。
重置密码OTP - 可以通过提供有效的OTP来重置密码。如果提供了SMS管理器，则它将工作。
激活账户 - 网站管理员添加的用户可以通过此页激活。
隐私 - 显示隐私政策的页面。
条款 - 显示条款和条件的页面。
常见问题 - 显示常见问题的页面。

注意：如果SMS管理器具有短信余额，则忘记密码OTP和重置密码OTP页面将工作。

模板表单

模板还提供了使用动态表单和评论系统的表单。

联系表单（动态表单）
反馈表单（自定义评论）
推荐表单（自定义评论）

私有页面

博客模板提供空白仪表板、用户博客帖子、用户资料、用户设置和日历。

仪表板 - 登录时显示的页面。
资料 - 基本信息 - 基本信息页面允许用户更新包括电子邮件、用户名、姓名、性别和出生日期在内的基本信息。
资料 - 账户 - 账户页面允许用户更新密码。
资料 - 地址 - 地址页面允许用户管理多个地址。
设置 - 设置页面允许用户配置包括隐私、通知和提醒在内的设置。
通知 - 显示用户通知。
提醒 - 显示用户提醒。
活动 - 显示用户活动。
事件 - 使用列表视图显示与用户关联的日历事件。
事件日历 - 使用日历视图显示与用户关联的日历事件。
事件卡片 - 使用卡片视图显示与用户关联的日历事件。
事件 - 创建 - 创建事件页面允许用户添加日历事件。
事件 - 更新 - 创建事件页面允许用户更新日历事件。
博客帖子 - 创建/更新博客元素、块和帖子。

cmsgears / template-blog

维护者

详细信息