grunt-acf

Exports AdvancedCustomFields to PHP. Grunt acts like a headless browser to fetch the export code and puts it into your destination file. Now also supports ACF 5.0 and higher.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-acf --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-acf');

acf task

Run this task with the grunt acf command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

baseUrl

Type: String default: undefined

This is your projects local URL. We need this to login.

user

Type: String default undefined

This is your wordpress user. It should have access to the ACF-Admin panel.

password

Type: String default undefined

This is the password for you wordpress user.

addons

Type: Object default false

Whether we'd like to enable loading the plugins automatically.

dest

Type: String default none

The Path to your export file

condition

Type: String default none

You can add extra-loading logic to your Export file. It has to be valid PHP and it will be rendered inside the if brackets like so: if( <condition>){ [..ACF Fields..] }

options: {
	baseUrl: 'myproject.dev',
	user: 'wpAdminUser',
	password: 'wpAdminPW123!!11',
	condition: "defined('APPLICATION_MODE') && APPLICATION_MODE === 'live'",
	addons: {
		repeater: true,
		gallery: true,
		flexible: true,
		options: true,
	}
},
dest: 'path/to/my/acf-export.php'