ACF Field Type Template
Welcome to the Advanced Custom Fields field type template repository. Here you will find a starter-kit for creating a new ACF field type. This start-kit will work as a normal WP plugin.
For more information about creating a new field type, please read the following article: http://www.advancedcustomfields.com/resources/tutorials/creating-a-new-field-type/
/assets: folder for all asset files.
/assets/css: folder for .css files.
/assets/images: folder for image files
/assets/js: folder for .js files
/fields: folder for all field class files.
/fields/FIELD_NAME-v5.php: Field class compatible with ACF version 5
/fields/FIELD_NAME-v4.php: Field class compatible with ACF version 4
/lang: folder for .pot, .po and .mo files
acf-FIELD_NAME.php: Main plugin file that includes the correct field file based on the ACF version
readme.txt: WordPress readme file to be used by the WordPress repository
This template uses
PLACEHOLDERS such as
FIELD_NAME throughout the file names and code. Use the following list of placeholders to do a 'find and replace':
FIELD_NAME: Single word, no spaces. Underscores allowed. eg. donate_button
FIELD_LABEL: Multiple words, can include spaces, visible when selecting a field type. eg. Donate Button
PLUGIN_URL: Url to the github or WordPress repository
PLUGIN_TAGS: Comma separated list of relevant tags
SHORT_DESCRIPTION: Brief description of the field type, no longer than 2 lines
EXTENDED_DESCRIPTION: Extended description of the field type
AUTHOR_NAME: Name of field type author
AUTHOR_URL: URL to author's website
FIELD_NAME-v4.php files (now renamed using your field name) and include your custom code in the appropriate functions.
Please note that v4 and v5 field classes have slightly different functions. For more information, please read:
README.md file with the appropriate information and delete all content above and including the following line.
ACF FIELD_LABEL Field
This ACF field type is compatible with:
- ACF 5
- ACF 4
- Copy the
acf-FIELD_NAMEfolder into your
- Activate the FIELD_LABEL plugin via the plugins admin page
- Create a new field via ACF and select the FIELD_LABEL type
- Please refer to the description for more info regarding the field type settings
readme.txt for changelog