acf-sync.php

<?php
/**
 * Plugin Name:       ACF Sync
 * Plugin URI:        https://github.com/johnssondane/acf-sync
 * Description:       Save ACF fields to JSON files all at once.
 * Version:           1.0.0
 * Author:            dane
 * Author URI:        https://github.com/johnssondane
 * License:           GPL v2 or later
 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain:       acf-sync
 */

if (!defined('ABSPATH')) {
    exit;
}

if (!class_exists('ACFSync')) {
    class ACFSync
    {
        private $initialized = false;

        private $key_path_array = [
            'ui_options_page' => 'options-pages',
            'post_type' => 'post-types',
            'taxonomy' => 'taxonomies',
            'group' => 'field-groups',
        ];

        private $option_name = 'acf_sync_json_relative_dir';
        private $option_default = 'uploads/acf-json';

        private function get_json_base_path()
        {
            $relative = get_option($this->option_name, $this->option_default);

            $relative = trim($relative, "/\\");
            $relative = sanitize_text_field($relative);

            return path_join(WP_CONTENT_DIR, $relative);
        }

        private function sanitize_relative_content_path($path)
        {
            $path = sanitize_text_field($path);
            $path = trim($path, "/\\");

            if ($path === '') return 'acf-json';

            if (
                str_starts_with($path, '/') ||
                str_starts_with($path, '\\') ||
                str_contains($path, '..') ||
                preg_match('/^[a-zA-Z]:\\\\/', $path)
            ) {
                return 'acf-json';
            }

            return $path;
        }

        public function __construct() {}

        public function init()
        {
            if ($this->initialized) return;

            if (!$this->check_dependencies()) {
                add_action('admin_notices', [$this, 'missing_dependencies_notice']);
                return;
            }

            add_action('admin_menu', [$this, 'sync_options_page'], PHP_INT_MAX, 1);
            add_filter('acf/json/save_paths', [$this, 'set_save_paths'], PHP_INT_MAX, 2);
            add_filter('acf/json/load_paths', [$this, 'set_load_paths'], PHP_INT_MAX, 1);
            add_action('admin_bar_menu', [$this, 'add_sync_button'], PHP_INT_MAX, 1);
            add_action('admin_post_acf_sync', [$this, 'handle_sync']);
            add_action('admin_notices', [$this, 'successful_sync_notice'], PHP_INT_MAX, 1);

            $this->initialized = true;
        }

        public function check_dependencies()
        {
            if (!function_exists('is_plugin_active')) {
                require_once ABSPATH . 'wp-admin/includes/plugin.php';
            }

            return is_plugin_active('advanced-custom-fields/acf.php') ||
                is_plugin_active('advanced-custom-fields-pro/acf.php');
        }

        public function missing_dependencies_notice()
        {
            echo '<div class="notice notice-error"><p>';
            echo esc_html__('Advanced Custom Fields Sync requires the Advanced Custom Fields plugin to be installed and active.', 'acf-sync');
            echo '</p></div>';
        }

        public function sync_options_page()
        {
            add_submenu_page(
                'edit.php?post_type=acf-field-group',
                'Sync',
                'Sync',
                'manage_options',
                'acf-sync',
                [$this, 'sync_options_page_content'],
            );
        }

        public function sync_options_page_content()
        {
            $relative_dir = get_option($this->option_name, $this->option_default);
?>
            <div class="wrap">
                <h1>JSON Sync</h1>

                <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
                    <?php wp_nonce_field('acf_sync_action'); ?>

                    <table class="form-table" role="presentation">
                        <tr>
                            <th scope="row">
                                <label for="acf_sync_json_relative_dir">ACF JSON directory</label>
                            </th>
                            <td>
                                <code>wp-content/</code>
                                <input
                                    type="text"
                                    id="acf_sync_json_relative_dir"
                                    name="acf_sync_json_relative_dir"
                                    value="<?php echo esc_attr($relative_dir); ?>"
                                    class="regular-text"
                                    placeholder="acf-json">
                                <p class="description">
                                    Directory relative to wp-content. Example: <code>acf-json</code> or <code>themes/my-theme/acf-json</code>.
                                </p>
                            </td>
                        </tr>
                    </table>

                    <input type="hidden" name="action" value="acf_sync">

                    <?php submit_button('Save & Sync'); ?>
                </form>
            </div>
<?php
        }

        public function set_save_paths($paths, $post)
        {
            $base = $this->get_json_base_path();

            if (!is_dir($base)) {
                wp_mkdir_p($base);
            }

            $key = $post['key'] ?? '';

            foreach ($this->key_path_array as $key_prefix => $path) {
                if (!str_starts_with($key, $key_prefix)) {
                    continue;
                }

                $dir = path_join($base, $path);

                if (!is_dir($dir)) {
                    wp_mkdir_p($dir);
                }

                return [$dir];
            }

            return $paths;
        }

        public function set_load_paths($paths)
        {
            $base = $this->get_json_base_path();

            foreach ($this->key_path_array as $_ => $path) {
                $paths[] = path_join($base, $path);
            }

            return $paths;
        }

        public function add_sync_button($wp_admin_bar)
        {
            if (!current_user_can('manage_options')) {
                return;
            }
        
            $url = admin_url('admin-post.php?action=acf_sync');
            $url = wp_nonce_url($url, 'acf_sync_action');
        
            $wp_admin_bar->add_node([
                'id'    => 'acf-sync',
                'title' => 'Sync',
                'href'  => $url,
            ]);
        }

        public function handle_sync()
        {
            if (!current_user_can('manage_options')) {
                wp_die(__('You do not have permission to run ACF sync.', 'acf-sync'));
            }
        
            check_admin_referer('acf_sync_action');
        
            if (isset($_POST['acf_sync_json_relative_dir'])) {
                $relative_dir = $this->sanitize_relative_content_path(
                    wp_unslash($_POST['acf_sync_json_relative_dir'])
                );
        
                update_option($this->option_name, $relative_dir);
            }
        
            $acf_content = array_merge(
                acf_get_raw_post_types(),
                acf_get_raw_taxonomies(),
                acf_get_field_groups()
            );
        
            if (function_exists('acf_get_options_pages')) {
                $acf_content = array_merge($acf_content, acf_get_options_pages());
            }
        
            foreach ($acf_content as $content) {
                acf_write_json_field_group($content);
            }
        
            wp_safe_redirect(
                add_query_arg(
                    [
                        'page'           => 'acf-sync',
                        'acf_sync_done'  => 1,
                        'acf_sync_count' => count($acf_content),
                    ],
                    admin_url('edit.php?post_type=acf-field-group')
                )
            );
        
            exit;
        }

        public function successful_sync_notice()
        {
            if (!isset($_GET['acf_sync_done'])) return;

            $count = absint($_GET['acf_sync_count'] ?? 0);

            echo '<div class="notice notice-success is-dismissible"><p>';
            echo esc_html(sprintf('ACF Sync: %d items processed.', $count));
            echo '</p></div>';
        }
    }

    function acf_sync()
    {
        global $acf_sync;

        if (!$acf_sync) {
            $acf_sync = new ACFSync();
            $acf_sync->init();
        }
        return $acf_sync;
    }

    acf_sync();
}