WordPress 插件：ACF Options For Polylang 使用教程

1. 项目目录结构及介绍

acf-options-for-polylang 插件的目录结构如下：

acf-options-for-polylang/
├── .github/              # GitHub 工作流程和配置文件
├── .gitattributes/       # Git 属性文件
├── .gitignore/           # Git 忽略文件
├── classes/              # 类文件目录
├── languages/            # 语言文件目录
├── composer.json         # Composer 配置文件
├── grumphp.yml           # GrumPHP 配置文件
├── phpcs.xml             # PHP Code Sniffer 配置文件
├── README.md             # 项目说明文件
├── LICENSE.md            # 项目许可证文件
├── license.txt           # 许可证文件
├── CHANGELOG.md          # 更新日志文件
├── autoload.php          # 自动加载文件
├── bea-acf-options-for-polylang.php  # 插件主文件
├── compat.php            # 兼容性文件
└── readme.txt            # WordPress 插件描述文件

目录说明：

• .github/: 包含 GitHub 工作流程和配置文件。
• .gitattributes/: 包含 Git 属性文件。
• .gitignore/: 包含 Git 忽略文件，用于指定在版本控制中应忽略的文件和目录。
• classes/: 包含插件的核心类文件。
• languages/: 包含插件的国际化语言文件。
• composer.json: 包含项目依赖和Composer配置。
• grumphp.yml: 包含 GrumPHP 配置，用于代码质量检查。
• phpcs.xml: 包含 PHP Code Sniffer 配置，用于代码风格检查。
• README.md: 包含项目的详细说明。
• LICENSE.md: 包含项目的许可证信息。
• license.txt: 包含项目的许可证文本。
• CHANGELOG.md: 包含项目的更新日志。
• autoload.php: 包含自动加载逻辑。
• bea-acf-options-for-polylang.php: 包含插件的主要逻辑。
• compat.php: 包含兼容性相关的代码。
• readme.txt: 包含WordPress插件描述信息。

2. 项目的启动文件介绍

项目的启动文件是 bea-acf-options-for-polylang.php。这个文件是插件的主文件，它负责初始化插件和注册必要的钩子。

启动文件内容：

<?php
/*
Plugin Name: ACF Options For Polylang
Description: 添加对 Polylang 的 ACF 选项页面支持。
Version: 1.1.12
Author: Be API
Author URI: https://www.beapi.fr/
*/

// 如果未定义 'ABSPATH'，则停止执行。
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 添加自动加载逻辑。
require_once( plugin_dir_path( __FILE__ ) . 'autoload.php' );

// 初始化插件。
function bea_acf_options_for_polylang_init() {
    // 你的初始化代码...
}
add_action( 'plugins_loaded', 'bea_acf_options_for_polylang_init' );

3. 项目的配置文件介绍

在这个插件中，主要的配置文件是 composer.json 和 grumphp.yml。

composer.json 配置文件：

composer.json 文件用于定义项目的依赖和Composer配置。

{
    "name": "wpackagist-plugin/acf-options-for-polylang",
    "description": "WordPress plugin for adding ACF options page support for Polylang.",
    "type": "wordpress-plugin",
    "require": {
        "php": "^5.6|^7.0|^7.1|^7.2|^7.3|^7.4",
        "advanced-custom-fields/acf": "^5.6",
        "polylang/polylang": "^2.0|^3.0"
    },
    "autoload": {
        "psr-4": {"BeAPI\\ACFOptionsForPolylang\\": "classes/"}
    }
}

grumphp.yml 配置文件：

grumphp.yml 文件用于定义 GrumPHP 的配置，它是一个用于代码质量检查的工具。

parameters:
    tasks:
        phpcs:
            standard: psr2
            warning_severity: 0
            error_severity: 1
            ignore_patterns:
                - vendor/
                - node_modules/

以上是关于 acf-options-for-polylang 插件的基本介绍和配置文件说明。在实际使用中，您可能还需要参考插件的官方文档和WordPress的插件使用指南。