README

MODX Evolution 的 DocLister

一个用于按预定规则输出表格信息的类。如果没有规则，则数据将显示为未经处理的原始数据，即所有字段和值都直接与数据库相匹配。

信息处理的规则在控制器中描述。主要控制器是 site_content，它定义了 site_content 文档与 TV 参数中的数据之间的关系。

基于 DocLister 类创建了 12 个片段

DocLister - 用于输出信息的核心片段，遵循 Ditto 和 CatalogView 片段的原理
DLcrumbs - 用于生成类似于 Breadcrumbs 片段的面包屑
DLglossary - 用于根据特定字段的首字符过滤文档
DLvaluelist - 用于替换 DropDownDocs 片段
DLTemplate - 用于替换 $modx->parseChunk()
DLFirstChar - 在块中按第一个字母选择文档和分组
DLPrevNext - 循环导航，在相邻文档之间前进和后退
DLMenu - 构建无限嵌套的菜单
DLSitemap - 构建 XML 网站地图
DLReflect - 构建日期列表
DLReflectFilter - 根据日期过滤文档
DLBeforeAfter - 根据当前日期进行过去和未来事件的分页

有用链接

文档: http://docs.evo.im/extras/doclister.html
关于 DocLister 的文章: http://modx.im/tag/doclister/

基于 DocLister 的组件

作者

如何发送 PullRequest

1. 在 AgelxNash/DocLister 的仓库上执行 "fork"，然后在您的本地开发环境中克隆它

git clone git@github.com:имя-вашего-пользователя/DocLister.git

2. 将基本仓库 DocLister 添加为远程仓库（remote），命名为 "upstream"

转到第一步中创建克隆的目录，并执行以下命令

git remote add upstream git://github.com/AgelxNash/DocLister.git

3. 从 DocLister 的基本仓库获取最新代码更改

git fetch upstream

您应该为每个新补丁从这一步开始，以确保您正在使用包含最新更改的代码。

4. 基于当前的 master 分支创建一个新的分支

git checkout upstream/master
git checkout -b 999-название-вашей-ветки

5. 编写代码

确保它工作 :)

6. 提交更改

添加更改后的文件

# один файл
git add путь/до/вашего/файла.php
# все измененные файлы
git add .

如果提交说明中包含补丁编号 #XXX，GitHub 将自动将其与您正在处理的补丁相关联

git commit -m "Описание коммита для тикета #42"

7. 从 upstream（在第 2 步中添加）获取最新代码更改

git pull upstream master

再次确保您的分支包含最新更改。如果出现冲突，请修复并重新提交。

8. 将更改推送到 github

git push -u origin 999-название-вашей-ветки

9. 向 DocLister 的基本仓库发送 pull request

转到您的 GitHub 仓库，点击 "Pull Request"，选择右侧的您的分支，并添加 "Pull Request" 的描述，以便 GitHub 自动将其与补丁关联。在注释中添加补丁编号 '#999'。

10. 等待代码审查

有人会审查您的代码，可能会要求您进行更改。如果发生这种情况，请回到第 5 步。

11. 删除分支

在您的代码被接受或拒绝之后，您可以从本地仓库和GitHub中删除分支

git checkout master
git branch -D 999-название-вашей-ветки
git push origin --delete 999-название-вашей-ветки

所有步骤简要说明

git clone git@github.com:ваше-имя-пользователя/DocLister.git
git remote add upstream git://github.com/AgelxNash/DocLister.git
git fetch upstream
git checkout upstream/master
git checkout -b 999-название-вашей-ветки
/* пишем код */
git add путь/до/вашего/файла.php
git commit -m "Описание коммита для тикета #42"
git pull upstream master
git push -u origin 999-название-вашей-ветки

evolution-cms-extras / doclister

维护者

详细信息