README

此包允许您使用Composer和Bower包开发并部署CMS Made Simple网站和模块。

它还提供了一个Vagrant虚拟机，便于设置开发环境。

设置开发环境

创建Composer项目： composer create-project torfs-ict/cmsms <路径>。
在创建的项目中运行 vagrant up。
浏览到 http://192.168.33.99/install 并按照CMSMS安装程序进行操作。
在CMSMS的 config.php 文件中包含Composer自动加载器

require_once(__DIR__ . '/vendor/autoload.php');

趣闻轶事

MySQL的root密码、用户名、用户密码和数据库名都是 cmsms。
PHPMyAdmin在Vagrant虚拟机中安装，可通过 http://192.168.33.99/phpmyadmin 访问。
在开发环境中运行Composer必须始终在Vagrant虚拟机中进行。

开发模块

所有模块（处于开发状态）都应该放在开发环境的 modules 目录中，并且应该有一个有效的 composer.json 文件，如下面从Google Maps模块的示例中可以看到。

{
    "name": "torfs-ict/cmsms-google-maps",
    "description": "Google Maps module for CMS Made Simple",
    "version": "1.0.0",
    "license": "MIT",
    "authors": [
        {
            "name": "Kristof Torfs",
            "email": "kristof@torfs.org"
        }
    ],
    "require": {
        "torfs-ict/cmsms": "^2.1"
    },
    "extra": {
        "cmsms": {
            "module": true,
            "name": "GoogleMaps",
            "bower": {
                "gmaps": "~0.4.22",
                "hint.css": "^2.3.2"
            }
        }
    }
}

composer.json要求

版本必须设置。
至少必须设置一个作者。
必须定义 extra/cmsms 部分。
- 必须将 module 字段设置为TRUE，以便我们的开发环境在安装时将其视为模块。
- 必须将 name 字段设置为实际模块名称。
- 必须包含 bower 字段，它包含Bower包需求（可选）。当安装/更新模块的Composer包时，这些需求将自动安装。

生成新的模块

创建模块目录并切换到该目录。
运行 php ../../src/Module.php

在开发环境中安装模块

将VCS添加到开发环境中composer.json的仓库中，例如。

"repositories": [{
    "type": "path",
    "url": "modules/GoogleMaps"
}]

将模块添加到composer.json中的要求，例如。

"requires": {
    "torfs-ict/cmsms-google-maps": "*"
}

在开发环境根目录中运行 composer update。

注意：如果您使用我们的脚本生成了模块，您可以跳过步骤1和2。

部署完成的项目

使用设置开发环境时使用的Composer create-project 命令。
确保您的虚拟主机的webroot指向cms目录。
将浏览器导航到安装目录并完成CMS Made Simple的安装。
在CMSMS的 config.php 文件中包含Composer自动加载器： require_once(__DIR__ . '/vendor/autoload.php');
删除安装目录。
为每个需要的模块运行 composer require。

torfs-ict / cmsms

维护者

详细信息