zentheme/wpikaday

为 WordPress 自定义设置提供的 Pikaday 日历控件。

1.0.1 2016-12-06 06:40 UTC

This package is not auto-updated.

Last update: 2024-09-29 01:19:58 UTC


README

本模块提供了一个基于 Pikaday 日期选择器 项目的 WordPress 自定义设置控件。该模块可以通过 composer 使用,因此可以添加到插件或主题中。

Pikaday 日期选择器具有非常全面的配置选项,其中大部分都可用于控件,您可以在 Github 上的 Pikaday 项目 页面上查看它们。

使用 composer 安装

按照官方说明下载并安装 Composer。有关用法,请参阅文档

在终端中运行以下命令以使用 Composer 安装模块。

$ composer require zentheme/wpikaday

由于此项目使用 PSR-4 自动加载,因此您需要使用 Composer 的自动加载器。

使用控件

以下是一个如何在插件或主题中使用该控件的简单示例。示例假设已经包含了 vendor/autoload.php 文件。

use Zentheme\Customizer\Control\PikadayControl;

// Projects customizer configuration
add_action( 'customize_register', function( $wpCustomize ) {
    // Add a section...
    $wpCustomize->add_section( 'pikaday_section', [
        'title' => 'Pikaday Section'
    ] );
    
    // Then a setting...
    $wpCustomize->add_setting( 'pikaday_setting', [
        'default' => '',
        'transport' => 'postMessage'
    ] );
    
    // ...and finally add the Pikaday control
    $wpCustomize->add_control( 
        new PikadayControl( $wpCustomize, 'pikaday_control', [
            'label' => 'Pikaday Calendar',
            'section' => 'pikaday_section',
            'settings' => 'pikaday_setting',
            'position' => 'bottom right',   // position the  datepicker
            'format' => 'MMMM Do YYYY'      // define the date format
            // ... add any other valid Pikaday params here
        ] )
    );
} );

注意

  • 许可协议:MIT 许可
  • 维护协议:语义化版本控制指南

作者

John Dundon