README

仅适用于 Wordpress MVC 的附加包。

Post Picker 是一个内置的 模态窗口，可以在 Wordprss 管理仪表板中用于选择/选择帖子。

** 这将与 VueJS 发生冲突。

• 安装
  • 在模板中配置
• 用法
  • 在主页面中排队
  • HTML 和 JS
  • 渲染
    • 模板
  • 选项
• 编码指南
• 版权

安装

此包需要 Composer。

将其添加到位于模板根目录的 composer.json 文件中

"amostajo/wordpress-add-on-post-picker": "2.0.*"

然后运行

composer install

或

composer update

以下载包及其依赖项。

在模板中配置

在您的模板配置文件中的 addons 数组选项中添加以下字符串行。

    'Amostajo\Wordpress\PostPickerAddon\PostPicker',

这应该添加到

• config\plugin.php 在 Wordprss 插件模板上
• config\theme.php 在 Wordprss 主题模板上

用法

在主页面中排队

在进行任何自定义代码之前，您需要将 Post Picker 加载到或排队到 Wordprss。

在您的模板主类中调用 addon_post_picker() 函数，如下所示

class Main extends Plugin
{
    public function metabox()
    {
        // The function must be called within your Main.php file
        $this->addon_post_picker();
    }
}

HTML 和 JS

创建一个可点击的元素，该元素将调用 Post Picker

<a id="post-picker-caller">
    Add Posts
</a>

使用所需选项初始化 Post Picker，类似于 jQuery

$("#post-picker-caller").postPicker({
    render: false,
    success: function (posts) {
        // YOUR CUSTOM CODE HERE
        // Example:
        $.each(posts, function(index) {
            // Print post in console
            console.log(this);
        });
    } 
});

渲染

Post Picker 有一个内置的渲染系统，可以轻松显示结果。

为此，您需要在 HTML 中添加两样东西。

• 模板：显示每个结果的模板。
• 占位符目标：用作结果占位符的目标元素。

使用前面示例的示例

<a id="post-picker-caller">
    Add Posts
</a>

<!-- TARGET PLACEHOLDER -->
<div id="post-picker-placeholder"></div>

<!-- TEMPLATE -->
<div id="post-picker-templateholder">
    <div class="post post-{{ ID }}">
        <img alt="{{ title }}">
        <a href="{{ permalink }}">{{ title }}</a>
        <input type="hidden" value="{{ ID }}">
    </div>
</div>

JavaScript 部分应如下所示

$("#post-picker-caller").postPicker({
    target: "#post-picker-placeholder",
    templateElement: "#post-picker-templateholder"
});

Post Picker 默认渲染结果。

模板

设置模板有 3 种方法。

• 在调用者内部（默认）：您的模板将是调用者标签内的 HTML。在示例情况下 #post-picker-caller。
• 元素：与前面的示例相同。
• 作为选项：将其作为 jQuery 选项传递。

以下是可用于显示的 帖子 属性

选项

编码指南

编码是 PSR-2 和 Wordprss PHP 指南的混合。

许可

Post Picker 是在 MIT 许可证条款下分发的免费软件。