插件快速入门

有一个单独的包将 Carbon Fields 作为 WordPress 插件加载。 设置方法如下:

  1. 浏览到您的 WordPress 根目录
  2. 在您选择的终端中执行以下操作:
    composer require htmlburger/carbon-fields-plugin​
  3. 将以下内容添加到您的 functions.php 文件的顶部:
    use Carbon_Fields\Container;
    use Carbon_Fields\Field;
    
    add_action( 'carbon_fields_register_fields', 'crb_attach_theme_options' );
    function crb_attach_theme_options() {
        Container::make( 'theme_options', __( 'Theme Options' ) )
            ->add_fields( array(
                Field::make( 'text', 'crb_text', 'Text Field' ),
            ) );
    }
    
    add_action( 'after_setup_theme', 'crb_load' );
    function crb_load() {
        require_once( ABSPATH . '/vendor/autoload.php' );
        \Carbon_Fields\Carbon_Fields::boot();
    }​
  4. 打开 /wp-admin/ - 你现在有一个全新的“Theme Options”管理部分,带有一个文本字段如果您的 composer.json 不是您的 WordPress 根目录,您必须添加以下内容(替换 YOUR_DESIRED_LOCATION):
    "extra": {
        "installer-paths": {
            "YOUR_DESIRED_LOCATION/vendor/{$vendor}/{$name}/": ["type:wordpress-plugin"]
        }
    }

没有Composer

如果您不想使用 composer 安装 Carbon Fields,您也可以使用我们的预构建 zip 包之一:

  1. 下载 https://carbonfields.net/zip/latest/(打开新窗口)或访问 https://carbonfields.net/release-archive/(打开新窗口)并手动选择下载
  2. 使用插件 -> 添加新页面上的“上传插件”按钮上传 .zip 或解压缩并将其上传到您的 plugins/ 目录
  3. 将以下内容添加到您的 functions.php 文件的顶部:
    use Carbon_Fields\Container;
    use Carbon_Fields\Field;
    
    add_action( 'carbon_fields_register_fields', 'crb_attach_theme_options' );
    function crb_attach_theme_options() {
        Container::make( 'theme_options', __( 'Theme Options' ) )
            ->add_fields( array(
                Field::make( 'text', 'crb_text', 'Text Field' ),
            ) );
    }
  4. 打开 /wp-admin/ - 你现在有一个全新的“Theme Options”管理部分,带有一个文本字段
注意:压缩包使用 Composer 的自动加载 PHP 类,但不需要您安装 composer。