bloke/ied_plugin_composer

在Textpattern CMS内部创建、发布和编辑插件

安装: 4

依赖: 0

建议者: 0

安全性: 0

星标: 7

关注者: 4

分支: 5

类型:textpattern-plugin

v1.2.1 2017-08-18 22:01 UTC

This package is not auto-updated.

Last update: 2024-09-15 02:28:13 UTC


README

在Textpattern CMS内部创建、发布和编辑插件。

在“扩展”标签下创建一个新页面,您可以在此编辑和导出已安装在Textpattern中的插件,以及创建或上传社区创建的新插件。

功能

  • 创建、编辑、上传或安装插件代码和文档,然后以标准Textpattern插件格式发布您的产品。
  • 完全支持官方zem_tpl.php插件模板和net-carver修改的“先代码”版本,它还包含一个用于帮助文本的“样式”段(尽管很少需要)。
  • 可选的语法检查器,以保护网站/管理员端免受不良代码的影响。
  • 支持各种格式的插件导出,允许您在插件创作器或您喜欢的编辑程序之间切换。您可以导出
    • 一个标准的BASE64编码文本文件。
    • 一个gzip版本(对大型插件很有用)。
    • 一个符合标准模板格式的php文件。
    • 单独的Textpacks——任何语言的组合。
  • 支持所有插件类型:库、公共和行政(带或不带AJAX)。
  • 如果您需要特殊权限的插件,请指定推荐的插件加载顺序。
  • 文档可以用Textile或HTML编写。
  • 利用TinyMCE WYSIWYG编辑器来编辑帮助部分,或者使用各种javascript语法高亮器/编辑器来编辑代码。有关可用的编辑器的更多信息,请参阅设置部分。
  • 内置Textile帮助查看器(感谢net-carver的插件帮助查看器),允许您在开发过程中预览帮助文本。
  • 设置代码“恢复点”,如果事情变得不顺利,可以回滚到该点。这也有助于将插件源代码恢复到安装状态。

安装和卸载

需要Textpattern 4.6.0+

stefdawson.com下载插件(v0.5及以上版本),将代码粘贴到Textpattern的管理员→插件页面,安装并启用插件。

当您安装插件或访问设置屏幕时,会自动创建默认首选项,通过点击扩展→插件创作器面板右上角的设置按钮。有关详细信息,请参阅设置部分。

要删除插件创作器(不!),只需像平常一样从管理员→插件面板删除它。所有首选项也会自动删除。注意:如果您已将插件设置为响应“删除”生命周期事件,则从插件创作器窗口本身删除插件将不会删除首选项。

此外,此插件可以使用Composer安装。

$ composer require bloke/ied_plugin_composer:*

列表面板

在主页顶部有一个可折叠区域,标签为安装。这将在创建插件部分处理;页面的其余部分列出所有已安装的插件。列包括

插件
: 点击插件名称可对其进行 编辑。如果该插件与相关联的偏好设置,您还会看到一个 [选项] 链接。
; 作者
: 如有可点击的作者,可访问其网站。
; 版本(修改后)
: 显示当前版本号以及插件是否已从创建或安装时进行修改。如果已修改,您可以点击版本号将插件代码恢复到安装状态或最后的 还原点
; 描述
: 插件功能的一行简短概述。
; 发布
: 三个链接
:: 发布 : 以 .txt 文件的形式导出插件,以便分发给其他 Textpattern 用户。
:: 压缩 : 以压缩(gzip)的 .txt 文件形式导出插件。
:: 帮助 : 显示(textile 处理的)插件文档(如果有)。
: 所有这些任务(以及更多)都可以在 编辑面板 中执行。
; 顺序
: 从 1(首先加载)到 9(最后加载)推荐的插件加载顺序。5 是默认值。
: 注意,如果您使用插件缓存目录,则此功能仅在模板中原本存在 $plugin['order'] 字符串的情况下才 可用。因此,如果您的加载顺序始终返回“5”,请直接编辑模板以添加该字符串,或者将插件粘贴到 空白插件模板 的相关部分并上传。
; 激活
: 通过点击此列的条目启用或禁用插件——这只会触发您已设置为触发的插件中的任何启用/禁用生命周期事件。

使用多选框(您可以按住 Shift 键点击以同时选择多个)来删除插件或进行大量更改。如果已告诉作曲家允许插件响应用户生命周期事件,则删除将仅触发“已删除”生命周期事件。

: 如果您正在使用插件缓存目录(管理→高级首选项),则上传到此目录的任何标准模板格式的插件都将立即可用于编辑和测试。您可以像上述常规已安装插件一样编辑和发布这些插件,但有以下例外

  • 没有“修改”或“还原点”的概念,因为文件始终代表最新版本。请使用您自己的外部版本控制。
  • 缓存插件“始终开启”且不需要安装。要停用插件,必须从插件缓存目录中删除文件。
  • 因此,生命周期通知事件(安装、删除、启用、禁用)不会从缓存目录中的插件触发。
  • 建议的加载顺序不能从列表面板中更改;只能通过 编辑面板 进行更改。指定的加载顺序仅在导出插件时写入文件。插件缓存目录中的所有插件的加载顺序按字母顺序排列。

创建、安装和命名插件

有几种方法可以从作曲家的列表面板创建插件。展开作曲家列表面板顶部的“安装”折叠项以查看它们。

首先是创建一个空白、空白的插件;为此使用第一个文本框和 创建新插件 按钮。请注意以下事项

  • : 如果您使用标准插件名称(例如 abc_my_plugin),它将在数据库中创建。
  • : 如果您将 .php 添加到插件名称中,它将在插件缓存目录中以标准模板格式创建。
  • 不要在插件名称中指定版本号 — 你应该使用编辑面板中的重命名文件导出选项来更改文件名为你喜欢的格式(见设置)。

创建插件的第二种方法是使用浏览/上传框上传。请注意

  • 你可以以下形式上传代码:
    • a. 标准插件 base64 .txt 文件。
    • b. 标准插件模板(无论是以代码优先还是以帮助优先,都包含 CSS 区域)。
    • c. 仅包含原始代码的 PHP 文件。
  • 使用此方法时,插件总是会安装到数据库中(通过 FTP 手动上传模板插件或创建一个新的 .php 扩展名并粘贴代码到其中,如果要将它放在插件缓存中)。
  • 如果插件存在,它将使用你的新信息进行更新。
  • 这是唯一可以上传带有 <?php ?> 标记的原始 PHP 的地方。其他所有地方都应该使用完整模板。
  • 在点击 上传 之前,如果你在上传小部件上面的框中添加了一个插件名称,那么你的插件将采用该名称。

你也可以像在 管理→插件 面板中一样安装插件,通过将标准插件 .txt 文件的全部内容复制粘贴到安装文本区域并点击 安装 按钮。注意,与核心的安装程序有一些不同

  • 没有预览步骤;插件将立即安装,所以请确保你信任代码!
  • 你可以使用出现的单选按钮选择是否允许插件运行其“安装”生命周期事件。
  • 在点击 安装 之前,你可以选择通过选择适当的单选按钮条目来让插件自动启用自己。
  • 单选按钮采用设置面板的默认设置。

按照惯例,每个插件都应该使用三个字母的前缀,然后是插件名称。你可以自由选择自己的三个字母前缀(通常是你的首字母缩写),但要注意避免其他插件作者已经使用的那些,这样人们才能了解你的工作。此外,它还将你的插件分组在插件仓库中。所有功能、变量(包括 DOM 节点)、CSS 类、Textpack 字符串以及你注入到全局作用域中的任何其他内容都应该以 至少 你的三个字母代码为前缀;最好是整个插件名称(或其缩写版本)以避免与自己的和其他插件的命名空间冲突。

编辑面板

这个面板是您制作杰作的地方。它分为多个部分和框。 面板 区域允许您在插件的不同部分之间切换。每个插件都有

  • 元内容,如名称、版本和标志。
  • PHP 代码。
  • Textpack 字符串。
  • 文档/样式。

您单独编辑每个部分以减少屏幕上的杂乱,并且当您切换子面板时,您的选择将被记住,以便在编辑其他插件时该面板出现。按 保存 将提交整个页面的更改 — 包括当前不可见的子面板。

元子面板

名称
:您的插件名称,您可以在任何时候更改它。请注意,如果您正在编辑来自插件缓存目录的文件,并且文件中的 $plugin['name'] 行被注释掉,您将无法更改插件名称;它将始终是文件的名称。
版本
:您插件的当前版本。您可以自由选择自己的版本控制约定。
:这些框的右侧将显示一些可选项目,这些项目将根据当前的操作模式出现
:: 恢复点(仅限数据库插件):勾选此复选框后(点击 保存 按钮),将当前代码存储为基准,您可以在以后的时间点“回滚”到该基准。请参阅 恢复点
:: 重命名文件(仅限 cache_dir 插件):默认情况下,当您在插件缓存目录中保存文件时,它会用您的更改覆盖。一旦插件发布,您通常会保留一个从 plugin_cache_dir 复制的副本以作安全保管。如果您随后修改了插件并增加了版本号,您可能希望更改文件名。勾选此复选框后(点击 保存 按钮),将插件缓存目录中的文件重命名为反映当前版本号。请参阅 设置面板 了解自定义文件名格式的详细信息。
:: 启用(仅限数据库插件):保存后切换插件的开关。
:: (文件名)(仅限 cache_dir 插件):您当前正在编辑的文件名。
; 描述
: 用一句话简要描述您的插件的核心功能/存在的理由。最大长度为 255 个字符。
; 作者
: 您!
; 网站
: 您的主页或插件页面。将在 列表面板 中通过作者名字进行超链接。
; 插件类型
: 选择最适合您的插件预期用途的类型。如果您选择“公共”并尝试在代码中访问管理端,当插件保存时将发出警告,以便您选择更合适的类型。
; 标志
: 选择要关联到插件的插件标志
:: 具有首选项:勾选此选项表示您的插件响应 plugin_prefs.your_plugin_name 事件。
:: 事件通知:勾选此选项表示您的插件响应 plugin_lifecycle.your_plugin_name 事件/步骤。
; 加载顺序
: 选择您认为用户应该加载插件的推荐顺序。大多数情况下,默认值“5”就足够了,但在需要设置环境或必须等待其他插件先加载的特殊情况下,您可能需要选择两侧的数字之一。请注意,这是一个 推荐,可以被网站管理员覆盖。如果插件已在网站上部署,则将使用已设置的加载顺序,而不管此值的设置如何;只有新安装将默认设置为此值。

插件代码

您的插件代码放在这里。写您的杰作,并单击主要的 保存 按钮(保存一切:代码、帮助、元数据等)或如果您只是更新代码部分,请使用子面板右上角的 保存代码 按钮,以实现快速后台保存。在保存过程中,textarea 变暗以显示它正在工作,尽管您仍然可以继续键入。当 textarea 返回完全可见性时,意味着保存过程已完成。您的代码(可选)在使用 保存代码 按钮时通过简单的语法检查器运行,并突出显示任何错误。 如果检测到语法错误,您的插件将不会保存

插件限制为 16Mb 的代码,因此编辑框下方还有一个字符计数器。如果您开始接近限制(!),可能值得考虑将您的插件分成几个部分或在微软工作,那里可以接受代码膨胀。

在 Firefox、Chrome 和 IE10+ 中,您可以使用 转到行: 文本框。输入行号并按 Enter 键跳转到代码中的该行。在其他浏览器中,结果可能会有所不同。

文本包字符串

在Textpattern 4.3.0之前,每当您向用户显示特定于插件的字符串时,编写自己的gTxt()函数将字符串打包到插件的一个区域中是有意义的。虽然方便,但这意味着任何想要在另一种语言中使用您的插件的人都必须编辑插件代码,并将您的字符串重写为目标语言,这会导致升级问题。

这个问题现在已经不存在了,因为Textpattern现在有了Textpack:可重新分发的文本文件,其中包含用于直接插入数据库的语言字符串。

请注意:Textpack区域与编辑面板的其余部分工作方式略有不同:大多数更改都会在您输入时实时发生。

在开始之前,您需要为插件定义一个文本包前缀。这通常是您的三个字母插件前缀加上一些唯一标识符,所有由插件使用的字符串都将以此标识符开始。例如,插件作曲家使用ied_plugin(尽管它可以使用ied_pcompied_pc等)。请注意,仅使用您的三个字母前缀可能不是明智的,因为您的未来插件可能需要类似名称的替代品,字符串将发生冲突。当然,您可能想要利用这一功能!

一旦输入前缀,您的光标离开框时,作曲家将存储前缀并立即在插件代码中搜索任何带有gTxt的函数调用中的此类前缀字符串。找到的任何内容都将列出,您可以立即开始输入当前选择的语言的替换文本。每当光标离开文本框时,其内容将直接保存到数据库中。

Textpack字符串可用于管理端、公共站点或两者。请为每个字符串选择最合适的位置从下拉菜单中选择。

如果您在代码中创建或重命名gTxt字符串,当您的光标离开文本区域时,新的字符串(s)将在列表顶部的文本包区域为您创建。请注意,它们将在您提供替换字符串之前写入数据库。

在创建/重命名替换字符串的过程中,如果它遗弃了另一个字符串,则遗弃的字符串将被突出显示,并将在其旁边出现一个[x]按钮。如果您希望将旧内容从框中复制出来并将其粘贴到您重命名的字符串中,现在就是时候了。一旦您确定您不再需要该字符串,请点击[x]按钮立即将其从数据库中删除。它将从所有语言中删除。

请注意

  • 如果您以编程方式引用字符串(例如,通过连接字符串部分以形成gTxt字符串名称,或遍历循环并使用变量替换),则它们将不会自动检测到。您必须使用“+”按钮手动添加此类字符串。
  • 任何以编程方式导出的Textpack字符串或不在gTxt()函数中的字符串将显示一个[x]按钮。您当然不应该删除这些字符串!
  • 完成完整保存(即不仅仅是保存代码)后,将显示为插件定义的所有字符串。任何派生的字符串仍将突出显示为潜在的孤儿。
  • 从选择列表中切换语言将立即加载该语言的字符串。
  • 点击加载与切换语言执行相同任务,并且它在您只有一个语言安装或希望刷新当前语言中的字符串时存在。

从当前插件导入字符串

自动查找功能成功依赖于两个因素

  • 字符串全部带有前缀。
  • 您的插件类型是AJAX类型之一(4或5)。

如果您正在将旧插件转换为Textpack方法,那么您可能会有数百个字符串需要逐个复制,这可能会很麻烦。作曲家可以尝试帮助您,但这仅适用于您在插件中有一个函数或方法来替换并返回字符串的情况。如果没有,现在可能是做这件事的时候,以节省自己一些麻烦!它不需要在代码中引用,只需存在并返回给定名称的字符串即可。

一旦您设置了这些,以下是一些步骤,您可以按这些步骤转换您的插件并批量获取所有必要的字符串

  1. 在您的插件gTxt()函数中,确保所有键都以前缀您的指定插件前缀开头。
  2. 全局替换任何对abc_plugin_gTxt('的引用,如果不是的话,替换为abc_plugin_gTxt('abc_prefix_
  3. 从作曲家窗口保存插件。
  4. 如果尚未设置,请输入Textpack前缀。
  5. 从函数加载字符串框中输入您的gTxt函数的名称,例如ied_plugin_gTxt。如果您的gTxt()方法在一个类中,请指定class_name::method_name
  6. 点击“Go”。

如果作曲家可以执行您选择的函数,它将执行并返回函数内部定义的字符串,自动将每个Textpack字符串填充到数据库中。一旦完成,所有字符串都填充完毕后,您就可以

  1. 全局替换插件代码中对abc_plugin_gTxt的调用,替换为核心gTxt
  2. 删除abc_plugin_gTxt函数。

Textpack字符串在保存插件时也写入cache_dir中任何您正在编辑的插件的文件,只要您使用的是包含$plugin['textpack']字符串的最新模板。

切换语言

如果您想在任何时候查看其他语言的已安装Textpack字符串,只需使用下拉列表选择一个即可。任何定义的字符串都将加载到Textpack字段中。您会看到一个计数器快速上升,显示它已经走了多远。作为翻译辅助,当您将鼠标悬停在Textpack条目上时,将显示您指定的默认语言的等效字符串(见setup)。您可以选择自己翻译字符串,也可以在插件发布后将翻译推迟给社区的其他成员。Textpack可以被贡献者链接到您的textpattern.org插件页面,并可以从Textpattern的Admin→Languages选项卡随时安装。

插件帮助

详细说明插件使用的文档。可以使用Textile编写。有一些文档指南作为良好的起点。请注意,这里的字符计数只是近似,因为当您的插件保存并将帮助转换为HTML时,它通常比Textile占用更多空间;请检查您的帮助文件在插件导出时是否正确渲染。

样式框用于您希望应用于文档的任何CSS样式规则,尽管您可能不需要现代管理主题。您被鼓励尽可能多地重复使用管理员的内核CSS规则,但如果没有适合的规则,最好通过将整个插件帮助部分包围在类似<div id="abc_help">h1. Docs go here...</div>的东西来专门针对您的文档。

请注意,插件帮助和样式都受到大小限制。由于它们都存储在同一64KB字段中,因此大小是共享的。样式不会被通过Textile处理器,因此您不需要添加<style>标签;作曲家会为您完成这项工作(但请参阅注意事项)。

点击插件帮助标题旁边的[文档]链接,以显示用户将看到的文档(即Textile处理为HTML)。任何长度超过64KB的帮助文本都会被截断,这样您可以验证所有文档都能适合用户的目标数据库。

分发

保存您的插件后,有一个部分允许您以各种格式导出您的插件。一个语言选择框控制了如何处理Textpack。如果您选择第一个(空)项目,则导出的文件中不包含Textpack信息。唯一的例外是您直接保存Textpacks:第一个项目是一个“所有语言”的快捷方式,以避免您必须选择它们。

  • 分发插件代码:这是一个直接复制“粘贴”区域,包含您的整个插件+文档。您可以复制整个区域并将其粘贴到“安装插件”框中。由于这会增加插件完整保存所需的时间,因此这部分是可选的,可以从设置面板启用。
  • 导出为abc_myplugin.txt:将插件帮助转换为HTML,并将插件保存到您的计算机上作为可分发的文本文件,以便其他Textpattern用户安装。如果您从相邻的选择列表中选择了任何Textpack语言,它们将与您的插件捆绑在一起,因此如果语言与安装插件的管理员使用的语言匹配,则将自动安装。
  • 导出为abc_myplugin.txt(压缩版):将插件帮助转换为HTML,并将插件保存为可分发的,gzip压缩的文本文件,以便其他Textpattern用户安装。对于大型插件或为受其主机严格大小限制的人提供替代方案非常有用。如果您从选择列表中选择了至少一种语言,则会捆绑Textpack字符串。
  • 导出为abc_myplugin.php:以Textpattern标准模板格式保存插件。如果您想保留插件(包括Textiled帮助标记),以便稍后编辑和重新发布/更新或与拥有插件作曲家或zem_tpl.php编译器的其他开发者共享,则非常有用。如果您选择,模板中会捆绑Textpack字符串。
  • 导出Textpack(s):从选择列表中选择一个或多个语言以收集所有插件Textpack字符串,并将它们作为可分发的文本文件下载,供其他textpattern用户安装或修改。您(或任何人)将(有一天)能够上传到textpattern.org的Textpack链接,以便从中央位置提供。

请注意,当以标准插件导出时,Textile处理器会尝试确定您是否使用了Textile;它只是查找文本化的标题(从h1.h6.)。将纯HTML通过Textile有时会导致编码问题,具体取决于原始字符集,因此始终最好尝试坚持使用Textile作为文档系统。

恢复点

当安装插件时,数据库中会保留其副本。如果随后编辑插件代码(非帮助文本),则认为插件被“修改过”;在插件作曲家的列表面板中体现。有时您可能希望将任何更改恢复到安装状态。

任何将插件标记为“修改过”的情况,版本号都会在列表面板中变为可点击。点击它(并确认您确实想要这样做)将删除您所做的任何更改,并将插件恢复到安装状态。

在编辑您自己的插件过程中,可能有时您希望在某个时刻“立下一个基准”,并表示“这是我的当前基准,我可能稍后想要返回”。也许您即将进行一些重大编辑或尝试一些实验性的内容,并希望有一个简单的回退机制。这就是“还原点”复选框的作用所在。

在完全保存插件时勾选该复选框,当前代码将成为您的新回滚点,并且插件将不再被标记为“修改过”。之前的任何更改都无法恢复,因此如果您希望回溯更早的版本,您将不得不依靠自己的备份。在创建还原点之后所做的任何编辑都可以通过访问列表面板并点击插件旁边的版本号来撤销。目前,数据库中只能存储一个回滚点。请注意,“还原点”复选框只在保存元数据时被忽略,因为您并没有保存任何代码。

设置面板

从主列表面板中点击设置可以访问插件设置。

; 插件编辑器
: 您可以选择使用第三方语法高亮器来编辑代码。当前支持EditArea、CodeMirror和CodePress。
: 在此处选择系统,并在下方的框中指定脚本和样式的URL。如果您的选择编辑器需要加载多个文件,请列出所有文件,并用逗号分隔。如果其中任何文件是样式表,请用css:作为文件名的前缀,这样插件就知道要插入一个<link rel="stylesheet" ...>标签而不是一个<script>标签。
: 如果您想向编辑器提供任何配置选项,请在“插件编辑器配置选项”文本区域中输入它们。按照它们的文档初始化脚本的方式,将它们写为name:value对,并用逗号分隔。
; 插件编辑器宽度
: 编辑面板中文本框的大小。设置为适合您的屏幕分辨率。如果需要,请包含单位(px、em、等);如果省略它们,则默认为像素。
; 帮助编辑器
: 您可以选择通过 Textile 手动编辑帮助,或者使用 TinyMCE 以获得更所见即所得的体验。
: 与插件代码编辑器类似,您需要告诉作曲家 JavaScript 文件的URL。您还可以提供配置选项。默认选项应能帮助您了解如何使用它们:请参阅 TinyMCE 文档以获取更多信息。
; 可选界面元素
: 选择您希望在界面中可见的编辑面板部分。
; 在安装/启用/禁用/删除插件时执行生命周期操作
: 当插件安装、启用、禁用或删除时,插件可以运行代码来执行安装或清理操作。选择在安装、启用/禁用或删除插件时允许执行的操作。您可以在作曲家的列表面板中选择。
: 在此处选择的“安装”复选框的值将成为安装子面板中的执行安装后操作单选按钮的默认选项。
; 安装后自动启用插件
: 是否允许插件在安装后自动开启,或保留其之前的状态。
: 在此处选择的设置将成为列表面板安装文本框下的默认单选按钮选择。
; 代码保存时语法检查
: 当您使用保存代码按钮时,是否运行代码通过语法检查。强烈建议在开发过程中保存您的管理端,以防止出现错误。
; Textpack语言列表
: 是否仅允许编辑当前已安装语言的字符串,或所有可用的 Textpattern 语言。
; 默认Textpack语言
: 插件字符串的主要语言(默认=任何)。如果您选择了一个未安装的语言(并且您将语言列表限制为仅安装的语言),默认语言将恢复到您当前的管理端语言。
: 注意,如果您在此处设置语言,当您导出 Textpack 或构建插件时,将期望用户在 Textpattern 中安装该语言。如果您将其保留为“任何”,则将从 Textpack 中省略语言标记,因此与插件捆绑的字符串(可能为英语)将安装到用户的默认语言中(可能不是英语)。通过强制默认语言,您将强制插件中的语言标记。因此,如果您的用户没有安装该语言(例如,某人只安装了 nl-nl 而没有英语),并且他们安装了您的插件,它将查看已安装的语言(nl-nl),将其与插件中的语言(en-gb)进行比较,发现它们不匹配,并将跳过 Textpack 的安装。这将导致用户的界面中充满了丑陋的abc_plugin_some_item字符串,而不是实际的翻译内容。
: 如果您正在单独分发 Textpack 并拥有大量库存,或者插件捆绑了大量 Textpack,这可能会很有用,但对于95%的情况,最好将默认文本包语言保留为任何,以确保您的插件用户至少可以获得一些翻译字符串,即使它们不是他们的“本地”语言。然后他们至少可以翻译它们并将 Textpack 分发给其他用户。
; PHP 导出顺序
:当您以标准模板格式保存插件时,这决定了您是希望代码块位于文件顶部,帮助块位于下方,还是相反。
导出插件文件名格式
导出压缩文件名格式
导出模板文件名格式
文本包文件名格式
:这些定义了导出插件/文本包时的文件名格式。第一个用于导出标准 BASE-64 插件;第二个用于压缩插件;第三个用于导出标准 PHP 模板,最后用于导出文本包。
:在您键入 {name} 的地方,将显示插件名称。同样,{version} 将被替换为当前插件的版本号。而 {lang} 将被替换为以下之一:1) 选择的语言代码,如 en-gb;2) 如果您选择将所有文本包导出为一个文件,则为 'all';3) 如果您选择导出多个,则为包中语言适用的国家缩写列表,例如 en+fi+nl+fr+de
:您可以在这些框中键入任何内容,但最好在每个框中包含一些替换字符串,以免出现名称/版本冲突。例如,如果您不喜欢将压缩插件导出为 pfx_my_plugin_v0.1_zip.txt,您可以更改它。也许您更喜欢 pfx_my_plugin-compressed-0.1.txt。在这种情况下,将第二个框设置为 {name}-compressed-{version}.txt
:请注意,通常应指定扩展名,以便您的系统/浏览器在导出文件时知道文件的类型,但这是可选的,因为已给出 MIME 类型,所以(好的)浏览器应该读取它。
缓存 Textiled 帮助路径
:如果您想利用帮助缓存,请在框中输入临时目录的路径。如果您更喜欢保存和导出速度较慢,请清空框!
:默认为 Textpattern 的临时目录。

注意/已知问题

  1. 当插件保存到 plugin_cache_dir 时,如果您没有在您的 CSS 块中放置 <style> 标记,它们将被自动添加到文本区域中,但 不会 保存到实际的模板中,直到您再次保存它(将文件导出为 PHP 文件不受影响)。所以如果您习惯于在保存后立即从您的 FTP 客户端手动下载文件,只需再次保存插件以确保即可。
  2. 从 gTxt 函数加载 Textpack 字符串将不起作用,除非您(可能暂时)将您的插件切换到 AJAX 类型之一。

编写插件

您应该注意 Textpattern 支持论坛上的 插件作者资源 主题,并且您可能还希望查看 Textpattern 文档中的 插件开发 指南和教程。

祝您编写插件愉快 :-)

作者

原始插件:Yura Linnyk
修改(v0.5+):Stef Dawson
一点风格:Steve Dickinson
以及众多论坛贡献者的帮助,无法一一列举。您知道您是谁,谢谢 ;-)