ACF 图像纵横比裁剪插件使用手册

ACF 图像纵横比裁剪插件使用手册

acf-image-aspect-ratio-crop Image Aspect Ratio Crop field for Advanced Custom Fields 项目地址: https://gitcode.com/gh_mirrors/ac/acf-image-aspect-ratio-crop

---

1. 目录结构及介绍

本项目是用于WordPress的Advanced Custom Fields(ACF)的扩展，名为acf-image-aspect-ratio-crop。以下是主要的目录和文件结构概述：

.
├── assets                  # 资源文件夹，存放CSS、JS等前端资源
│   └── src                # 前端开发源码
├── fields                  # 包含自定义字段相关代码
├── tests                   # 测试相关文件
├── dist                    # 构建后的产出目录
├── .editorconfig           # 编辑器配置文件
├── .gitignore              # Git忽略文件列表
├── .nvmrc                 # Node版本管理器设置文件
├── prettierrc.js           # Prettier代码格式化配置
├── Dockerfile              # Docker构建文件
├── LICENSE.md               # 许可证文件，遵循GPLv2或更高版本
├── README.md               # 项目说明文件
├── acf-image-aspect-ratio-crop.php # 主插件文件
├── composer.json            # Composer依赖管理文件
├── docker-compose.yml      # Docker Compose配置文件
├── package-lock.json       # npm包锁定文件
├── package.json             # npm包描述文件
├── readme.txt               # 另一个文档资源
├── webpack.config.js       # Webpack配置文件
└── wordpress.ini           # 特定于WordPress的配置

• acf-image-aspect-ratio-crop.php: 插件主入口文件，负责加载插件功能。
• assets: 存储前端JavaScript和CSS文件，用于定制图像裁剪界面。
• fields: 包含了自定义ACF字段逻辑实现。
• tests: 测试代码，确保功能的正确性。

---

2. 启动文件介绍

主启动文件：acf-image-aspect-ratio-crop.php

该文件初始化插件，注册必要的钩子（hooks）和过滤器（filters），与WordPress的核心进行交互，并激活插件的主要功能。当这个文件被WordPress加载时，它执行以下关键操作：

• 检查依赖项，如WordPress和ACF的版本。
• 注册新的ACF字段类型，使得在ACF界面上可以创建“图像纵横比裁剪”类型的字段。
• 加载本地化的字符串以支持多语言环境。
• 引入其他必要的脚本和样式到前端编辑界面。

---

3. 配置文件介绍

该项目中并没有传统意义上的配置文件，其配置主要是通过WordPress的行动（actions）和过滤器（filters）系统以及ACF的自定义字段选项来实现的。然而，对插件行为有影响的关键“配置”分散在以下几个方面：

• acf-image-aspect-ratio-crop.php 中包含了插件基本配置，如版本号、作者信息等，这也间接地影响插件的启动条件。
• .env 或者类似环境配置文件：虽然示例中没有直接提供，但在开发环境中，开发者可能会使用此类文件来管理API密钥、数据库连接等配置。
• WordPress的ACF设置页面：实际应用中，用户通过ACF图形界面创建“Image Aspect Ratio Crop”字段时设定的具体参数，如裁剪模式（像素大小、纵横比或自由裁剪）、指定的宽高比例等，这些构成了使用上的配置。

总结，该插件的配置更多依赖于WordPress和ACF提供的框架内设置，而不是独立的配置文件。用户通过WordPress的后端界面完成具体配置工作。

acf-image-aspect-ratio-crop Image Aspect Ratio Crop field for Advanced Custom Fields 项目地址: https://gitcode.com/gh_mirrors/ac/acf-image-aspect-ratio-crop