/acf-multisite-post-object

Primary LanguagePHP

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 starter-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/

Structure

  • /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/multisite_post_object-v5.php: Field class compatible with ACF version 5
  • /fields/multisite_post_object-v4.php: Field class compatible with ACF version 4
  • /lang: folder for .pot, .po and .mo files
  • acf-multisite_post_object.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

step 1.

This template uses PLACEHOLDERS such as multisite_post_object throughout the file names and code. Use the following list of placeholders to do a 'find and replace':

  • multisite_post_object: Single word, no spaces. Underscores allowed. eg. donate_button
  • Multisite Post Object: Multiple words, can include spaces, visible when selecting a field type. eg. Donate Button
  • https://github.com/heyjones/acf-multisite-post-object: Url to the github or WordPress repository
  • acf, multisite, post object: Comma separated list of relevant tags
  • Select posts from other blogs in a multisite installation: Brief description of the field type, no longer than 2 lines
  • EXTENDED_DESCRIPTION: Extended description of the field type
  • Chris Jones: Name of field type author
  • http://heyjones.com: URL to author's website

step 2.

Edit the multisite_post_object-v5.php and multisite_post_object-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:

step 3.

Edit this README.md file with the appropriate information and delete all content above and including the following line.

ACF Multisite Post Object Field

Select posts from other blogs in a multisite installation

Description

EXTENDED_DESCRIPTION

Compatibility

This ACF field type is compatible with:

  • ACF 5
  • ACF 4

Installation

  1. Copy the acf-multisite_post_object folder into your wp-content/plugins folder
  2. Activate the Multisite Post Object plugin via the plugins admin page
  3. Create a new field via ACF and select the Multisite Post Object type
  4. Please refer to the description for more info regarding the field type settings

Changelog

Please see readme.txt for changelog