====== CMSimple ======


与Dokuwiki一样，CMSimple是一种Flat-file database CMS，即使用纯文本文件作为数据存储的内容管理系统。

CMSimple（https://www.cmsimple.org/）是一个开源内容管理系统，标榜架构简单，程式档案小并且反应快速，不需要使用数据库。系统以PHP编写，可以在各种平台上运行。CMSimple_XH（https://www.cmsimple-xh.org/）中CMSimple的一个分支版本。

两个版本的差别有专文说明：https://cmsimpleforum.com/viewtopic.php?f=16&t=7861

===== 系统要求 =====

php 5.6或更高版本。

===== 部署CMSimple =====


1、下载源代码（2019-10-14最新版本CMSimple 4.8），解压并删除以“ 2”开头的文件夹；在userfiles目录下添加downloads空目录。

2、以源码方式打开readme.php，记录设置默认密码（test）的代码
  $cf['security']['password']="\$P\$BxAqSVtvibGUSTyiCouFJZ5RKzmZn81";
然后删除readme.php。

3、上传剩余文件/文件夹到站点指定目录。

4、设置文件/文件夹权限。

设置以下文件夹所有权限 (chmod 777)

  ./content
  ./userfiles
  ./userfiles/all subfolders
  ./cmsimple/languages

设置以下文件可写权限 (chmod 666)

  ./disabled_plugins.txt
  ./cmsimple/config.php
  ./cmsimple/log.php
  ./cmsimple/languages/ all files
  ./content/content.php
  ./content/pagedata.php
  ./templates/your_template/template.htm
  ./templates/your_template/stylesheet.css

===== CMSimple使用要点 =====

登录：登录链接在页脚底部右侧。首次登录按提示修改密码（默认密码test），用户名是可选的。

创建、发布和删除文章：h1–h3将创建新页面，h4–h6在页面中声明三级标题。使用内置Pagemanager插件（从管理菜单Pages进入），可以简化页面的创建、重命名、移动和删除。清空页面容易并保存，将删除当前页面（类似Dokuwiki的操作）。

标题重复：如果出现"标题重复 1"这样的路径，检查同级标题是否重复，或者上一级标题内容超过15个字。

编辑器：如果要在CMSimple外使用其他编辑器打开和保存文件，需为“无BOM（字节顺序标记）的utf-8”格式。

> 例如notepad ++默认可行，而类似WINDOWS自带的记事本等软件，在保存一个以UTF-8编码的文件时，会在文件开始的地方插入三个不可见的字符（0xEF 0xBB 0xBF，即BOM）。它是一串隐藏的字符，用于让记事本等编辑器识别这个文件是否以UTF-8编码。对于一般的文件，这样并不会产生什么麻烦。但对于 PHP来说，BOM是个大麻烦。PHP并不会忽略BOM，所以在读取、包含或者引用这些文件时，会把BOM作为该文件开头正文的一部分。

重设密码：将从readme.php文件记录的

  $cf['security']['password']="\$P\$BxAqSVtvibGUSTyiCouFJZ5RKzmZn81";
  
恢复到./cmsimple/config.php，即重设密码为test。

模板和插件：目录分别是templates和plugins，直接把模板和插件源文件夹放入相应目录即可。