WP Manifestindependent plugin directory
manifest / developer / acf_create_field

Wordpress ACF importer

Wordpress ACF (Advanced Custom Fields) importer. Allows programmatical import of XML files containing ACF fields into Wordpress, previously exported by the plugin itself.

by Maciej Gurban · github.com/maciej-gurban/acf_create_field · website

5stars
2forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/maciej-gurban/acf_create_field/archive/refs/heads/master.zip

Readme

WP ACF Importer

The plugin allows programmatical import of XML files containing ACF (Advanced Custom Fields) into Wordpress. It expects one ACF field (post of 'acf' type) at a time. XML syntax expected by the plugin needs to be the output of ACF plugin's export function.

The plugin supports Wordpress Multisite Network and auto updates if GitHub Updater plugin is installed.

Installation

Uploading in WordPress Dashboard

  1. Navigate to the 'Add New' in the plugins dashboard
  2. Navigate to the 'Upload' area
  3. Select wp_acf_importer.zip from your computer
  4. Click 'Install Now'
  5. Activate the plugin in the Plugin dashboard

Using FTP

  1. Download wp_acf_importer.zip
  2. Extract the wp_acf_importer directory to your computer
  3. Upload the wp_acf_importer directory to the /wp-content/plugins/ directory
  4. Activate the plugin in the Plugin dashboard

Plugin usage

Plugin expects $xml_string parameter to be passed. It should contain the contents of the XML file that is produced by ACF plugin upon export of an ACF field. The plugin will try to create one new ACF post unless one already exists, and then populate it with fields. To insert more than one field (a clone) with the same title, you should pass true as a second parameter.

Sample code (to be used in, for example, theme's functions.php file):

$acf_import = WP_ACF_Importer::get_instance();

$acf_field = file_get_contents('advanced-custom-field-export.xml');

if( $acf_import->acf_create_field( $acf_field) ) {
    echo 'Field created successfully.';
}
else {
    echo 'Import has not been performed.';
}

Parameters

Plugin source code extract:

acf_create_field( $xml_string, $allow_duplicates = false, $update_if_exists = false )
Parameter name Type Default value Required Description
$xml_string string null yes string containing the imported XML
$allow_duplicates bool false no set to true to allow posts with identical post_name
$update_if_exists bool false no set to true to overwrite existing ACF post with new post_meta (sets of fields to be edited in the back-end)

Read the full README on GitHub →