giantpeach/acf-relative-urls
Composer 安装命令:
composer require giantpeach/acf-relative-urls
包简介
Stores ACF link/URL fields as relative paths for environment portability
README 文档
README
Stores ACF link and URL fields as relative paths for environment portability.
Problem
ACF stores link fields with absolute URLs. When migrating databases between environments (local → staging → production), these URLs break unless you run search-replace scripts.
Solution
This mu-plugin intercepts ACF field saves/loads:
- On save: Converts internal absolute URLs to relative paths
- On load: Converts relative paths back to absolute URLs using current site URL
Installation
Via Composer (Bedrock)
composer require giantpeach/acf-relative-urls
Manual
Copy acf-relative-urls.php to your mu-plugins directory.
How It Works
| Action | Input | Stored in DB |
|---|---|---|
| Save (local) | https://mysite.lndo.site/about |
/about |
| Load (local) | /about |
https://mysite.lndo.site/about |
| Load (production) | /about |
https://mysite.com/about |
External URLs (e.g., https://google.com) are not modified.
Supported Field Types
link- ACF Link field (array with url, title, target)url- ACF URL field (plain string)
License
MIT
统计信息
- 总下载量: 26
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 2
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2026-01-19