README

这是什么？

发布是一个宝塔内容模块，负责处理通用和复杂的内容结构。

发布是一个两个成功的宝塔模块的合成：文章（由Michel Dalle创建）和Xarpages（由Jason Judge创建），以及一些额外的概念，目的是使其成为宝塔中的完整内容管理系统。

1. 它完全基于动态数据。
2. 它考虑到多语言内容。
3. 它直接支持网络发布的功能（如关键词、页面标题），而不是依赖于附加组件。
4. 它侧重于尽可能地通过UI管理内容，而不是通过模板编辑。
5. 它设计得易于使用，应用强大，易于扩展。

为什么还需要另一个内容管理模块？发布的 predecessors 每个都有自己的优点。文章模块是高端内容发布模块，而Xarpages用于简单的可以在页面树中可视化的内容，其页面可以是不同类型内容的容器。然而，在编写的时候，宝塔缺少一个成熟的数据管理层，即现在形式的动态数据。文章和Xarpages都求助于自定义功能来填补空白。

同时，宝塔的演变使其能够用更少的代码实现更多的功能。发布模块希望吸收其前辈的好思想，并将它们进一步推进。

概念

1. 发布

一个发布，或页面，是由发布模块生成的网页。它可以包含

• 几个内容块（标题、正文、文件上传小部件、日期、日历等）。内容利用动态数据的属性进行输入和显示。
• 配置设置，影响内容的显示，例如发布时间、类似页面的链接、自定义模板等。
• 配置设置，定义页面在流程中的行为，例如其状态或类别。
• 访问设置，定义谁可以阅读、编辑、删除页面或添加新页面。

页面可以以树状结构排列，因此支持一种自然的导航方案，其中一个页面被视为另一个页面的“子页面”。这种结构可能更适合任何给定的站点，但在许多情况下是一种有用的后备方案。

页面还可以根据其发布类型（见下文）显示。

页面的显示方式主要取决于其状态。发布模块支持以下状态

• active：任何有适当访问权限的人都可以显示页面。
• frontpage：页面显示在站点的“首页”上。
• inactive：页面不对大多数用户显示，但可以在后台进行修改。
• draft：页面可以被选定的用户“预览”。
• empty：页面是其子页面在页面树中的占位符。它在导航中存在，但不会显示任何自己的内容。
• deleted：页面仅对网站管理员可见。注意：页面永远不会被物理删除，而是设置为“已删除”状态。

2. 发布类型

与前辈们一样，出版物模块支持出版物类型。这些类型代表要发布的不同内容。实际上，11种预配置的出版物类型在很大程度上与文章模块（新闻、文档、下载等）的类型相对应。出版物模块可以同时管理不同类型的“出版物”，例如新闻出版物、不同部分的长篇文档、常见问题解答等。

每种出版物类型定义了一组具有共同特征的页面。出版物类型有自己的配置设置，除非特别覆盖，否则其页面会继承这些设置。反过来，出版物类型会从出版物模块的全局设置中继承一些设置，例如访问规则。

出版物类型相当灵活。它们可以互换（例如，将新闻文章类型转换为文档类型），但要注意，在某些情况下，页面的内容可能会因此发生变化。

特别是，每种出版物类型都有以下默认模板：

• 输入：用于在创建或修改页面时输入内容的输入表单。
• 摘要显示：在显示一组出版物时使用的显示模板，例如新闻文章列表。
• 详细显示：用于显示单个页面的模板。

由于出版物类型本质上属于动态数据对象，因此创建新类型相对容易。这涉及克隆现有类型（通常是所谓的通用出版物类型）及其模板，并进行适当的修改。

3. 翻译

出版物模块支持不同的地区/语言。这些不是Xaraya核心支持的地区，而是可以由语言数据属性独立定义。这允许模块包含网站整体不需要定义的语言的内容。

每个页面可以有支持的所有不同语言的翻译。翻译简单地是同一出版物类型的另一个页面，它是给定页面的“子页面”，通常包含相同的内容，但使用不同的语言。

翻译在树结构或列表显示中会被忽略，只有在父页面被修改时才会显示。页面的哪种翻译将显示给观众，通常取决于通过角色语言块选择的语言。如果某种语言不可用，则显示父页面。

4. 分类

任何类型的出版物都可以组织到分类中。您可以在不同的出版物类型中使用一个或多个常见分类，或为每种文章类型使用特定分类，或使用您可能喜欢的任何组合。

在开始指定哪些文章类型将使用哪些分类之前，您应该通过分类管理菜单创建您想要的分类。在安装此模块时，已为出版物定义了一组默认分类，作为开始示例。（当然，您可以稍后调整分类。）

一旦您有一组希望用于出版物的分类，您可以去出版物配置，并指定每种出版物类型可以使用的分类数量以及要使用的“基本分类”。

“基本分类”是您分类树中的任何起始点，以下将包含人们提交或查看出版物时可以选择的实际列表（或子树）中的分类。例如，您可以使用一个名为“主题”的基本分类，其中包含与您的网站相关的不同主题的列表，以及另一个名为“城市”的基本分类，其中包含您将提供区域性新闻的城市或地点列表。

一个主题可能是“好餐馆”，一个城市可能是“布鲁塞尔”，这样人们就可以浏览有关布鲁塞尔好餐馆的任何出版物，例如。

3. 提交或添加出版物

状态 = 已提交、已拒绝、已批准或首页（对使用该功能的出版物类型！）

4. 管理每种出版物的概览和显示

在 出版物配置 中，设置起始视图（列表/浏览），列数和项目数，显示分类链接 + 评论数（+性能影响）

+ 适配特定模板！

5. 管理您的“首页”

参照首页状态和列数、项目数 - 需要扩展

6. 添加计数器、评分、评论、表情符号、bb-code 等。

参照钩子 + 关于计数器的特殊说明

7. 组织权限

这真的需要一个权限向导

8. 短网址支持

在“基础”管理员中总体启用/禁用 + 在“出版物”管理员中具体启用/禁用 + 使用模块别名

模块别名似乎已被禁用 - 如果你想尝试，请在 includes/xarServer.php 中取消注释该行

包含的区块

• 特色项目
• 术语表
• 随机
• 相关
• 顶部项目

包含的钩子

搜索钩子，提供搜索您单个出版物功能。