path = plugin_dir_path(__FILE__); $this->dir = plugins_url('',__FILE__); $this->version = '3.5.4.1'; $this->upgrade_version = '3.4.1'; // this is the latest version which requires an upgrade $this->cache = array(); // basic array cache to hold data throughout the page load $this->defaults = array( 'options_page' => array( 'capability' => 'edit_posts', // capability to view options page 'title' => __('Options','acf'), // title / menu name ('Site Options') 'pages' => array(), // an array of sub pages ('Header, Footer, Home, etc') ), 'activation_codes' => array( 'repeater' => '', // activation code for the repeater add-on (XXXX-XXXX-XXXX-XXXX) 'options_page' => '', // activation code for the options page add-on (XXXX-XXXX-XXXX-XXXX) 'flexible_content' => '', // activation code for the flexible content add-on (XXXX-XXXX-XXXX-XXXX) 'gallery' => '', // activation code for the gallery add-on (XXXX-XXXX-XXXX-XXXX) ), ); // set text domain load_plugin_textdomain('acf', false, basename(dirname(__FILE__)).'/lang' ); // controllers $this->setup_controllers(); // actions add_action('init', array($this, 'init')); add_action('admin_menu', array($this,'admin_menu')); add_action('admin_head', array($this,'admin_head')); add_action('acf_save_post', array($this, 'acf_save_post'), 10); // save post, called from many places (api, input, everything, options) // filters add_filter('acf_load_field', array($this, 'acf_load_field_defaults'), 5); add_filter('post_updated_messages', array($this, 'post_updated_messages')); // ajax add_action('wp_ajax_get_input_metabox_ids', array($this, 'get_input_metabox_ids')); return true; } /* * Init * * @description: * @since 1.0.0 * @created: 23/06/12 */ function init() { // setup defaults $this->defaults = apply_filters('acf_settings', $this->defaults); // allow for older filters $this->defaults['options_page']['title'] = apply_filters('acf_options_page_title', $this->defaults['options_page']['title']); // setup fields $this->setup_fields(); // Create ACF post type $labels = array( 'name' => __( 'Field Groups', 'acf' ), 'singular_name' => __( 'Advanced Custom Fields', 'acf' ), 'add_new' => __( 'Add New' , 'acf' ), 'add_new_item' => __( 'Add New Field Group' , 'acf' ), 'edit_item' => __( 'Edit Field Group' , 'acf' ), 'new_item' => __( 'New Field Group' , 'acf' ), 'view_item' => __('View Field Group', 'acf'), 'search_items' => __('Search Field Groups', 'acf'), 'not_found' => __('No Field Groups found', 'acf'), 'not_found_in_trash' => __('No Field Groups found in Trash', 'acf'), ); register_post_type('acf', array( 'labels' => $labels, 'public' => false, 'show_ui' => true, '_builtin' => false, 'capability_type' => 'page', 'hierarchical' => true, 'rewrite' => false, 'query_var' => "acf", 'supports' => array( 'title', ), 'show_in_menu' => false, )); // register acf scripts $scripts = array( 'acf-fields' => $this->dir . '/js/fields.js', 'acf-input-actions' => $this->dir . '/js/input-actions.js', 'acf-input-ajax' => $this->dir . '/js/input-ajax.js', 'acf-datepicker' => $this->dir . '/core/fields/date_picker/jquery.ui.datepicker.js', ); foreach( $scripts as $k => $v ) { wp_register_script( $k, $v, array('jquery'), $this->version ); } // register acf styles $styles = array( 'acf' => $this->dir . '/css/acf.css', 'acf-fields' => $this->dir . '/css/fields.css', 'acf-global' => $this->dir . '/css/global.css', 'acf-input' => $this->dir . '/css/input.css', 'acf-datepicker' => $this->dir . '/core/fields/date_picker/style.date_picker.css', ); foreach( $styles as $k => $v ) { wp_register_style( $k, $v, false, $this->version ); } } /* * get_cache * * @description: Simple ACF (once per page) cache * @since 3.1.9 * @created: 23/06/12 */ function get_cache($key = false) { // key is required if( !$key ) return false; // does cache at key exist? if( !isset($this->cache[$key]) ) return false; // return cahced item return $this->cache[$key]; } /* * set_cache * * @description: Simple ACF (once per page) cache * @since 3.1.9 * @created: 23/06/12 */ function set_cache($key = false, $value = null) { // key is required if( !$key ) return false; // update the cache array $this->cache[$key] = $value; // return true. Probably not needed return true; } /* * setup_fields * * @description: Create an array of field objects, including custom registered field types * @since 1.0.0 * @created: 23/06/12 */ function setup_fields() { // include parent field include_once('core/fields/acf_field.php'); // include child fields include_once('core/fields/acf_field.php'); include_once('core/fields/text.php'); include_once('core/fields/textarea.php'); include_once('core/fields/wysiwyg.php'); include_once('core/fields/image.php'); include_once('core/fields/file.php'); include_once('core/fields/number.php'); include_once('core/fields/select.php'); include_once('core/fields/checkbox.php'); include_once('core/fields/radio.php'); include_once('core/fields/true_false.php'); include_once('core/fields/page_link.php'); include_once('core/fields/post_object.php'); include_once('core/fields/relationship.php'); include_once('core/fields/date_picker/date_picker.php'); include_once('core/fields/color_picker.php'); // add child fields $this->fields['none'] = new acf_Field($this); $this->fields['text'] = new acf_Text($this); $this->fields['textarea'] = new acf_Textarea($this); $this->fields['wysiwyg'] = new acf_Wysiwyg($this); $this->fields['image'] = new acf_Image($this); $this->fields['file'] = new acf_File($this); $this->fields['number'] = new acf_Number($this); $this->fields['select'] = new acf_Select($this); $this->fields['checkbox'] = new acf_Checkbox($this); $this->fields['radio'] = new acf_Radio($this); $this->fields['true_false'] = new acf_True_false($this); $this->fields['page_link'] = new acf_Page_link($this); $this->fields['post_object'] = new acf_Post_object($this); $this->fields['relationship'] = new acf_Relationship($this); $this->fields['date_picker'] = new acf_Date_picker($this); $this->fields['color_picker'] = new acf_Color_picker($this); // add repeater if($this->is_field_unlocked('repeater')) { include_once('core/fields/repeater.php'); $this->fields['repeater'] = new acf_Repeater($this); } // add flexible content if($this->is_field_unlocked('flexible_content')) { include_once('core/fields/flexible_content.php'); $this->fields['flexible_content'] = new acf_Flexible_content($this); } // add gallery if($this->is_field_unlocked('gallery')) { include_once('core/fields/gallery.php'); $this->fields['gallery'] = new acf_Gallery($this); } // hook to load in third party fields $custom = apply_filters('acf_register_field',array()); if(!empty($custom)) { foreach($custom as $v) { //var_dump($v['url']); include($v['url']); $name = $v['class']; $custom_field = new $name($this); $this->fields[$custom_field->name] = $custom_field; } } } /* * setup_fields * * @description: * @since 3.2.6 * @created: 23/06/12 */ function setup_controllers() { // Settings include_once('core/controllers/settings.php'); $this->settings = new acf_settings($this); // upgrade include_once('core/controllers/upgrade.php'); $this->upgrade = new acf_upgrade($this); // field_groups include_once('core/controllers/field_groups.php'); $this->field_groups = new acf_field_groups($this); // field_group include_once('core/controllers/field_group.php'); $this->field_group = new acf_field_group($this); // input include_once('core/controllers/input.php'); $this->input = new acf_input($this); // options page include_once('core/controllers/options_page.php'); $this->options_page = new acf_options_page($this); // everthing fields include_once('core/controllers/everything_fields.php'); $this->everything_fields = new acf_everything_fields($this); // Third Party Compatibility include_once('core/controllers/third_party.php'); $this->third_party = new acf_third_party($this); } /* * admin_menu * * @description: * @since 1.0.0 * @created: 23/06/12 */ function admin_menu() { // add acf page to options menu add_utility_page(__("Custom Fields",'acf'), __("Custom Fields",'acf'), 'manage_options', 'edit.php?post_type=acf'); } /* * post_updated_messages * * @description: messages for saving a field group * @since 1.0.0 * @created: 23/06/12 */ function post_updated_messages( $messages ) { global $post, $post_ID; $messages['acf'] = array( 0 => '', // Unused. Messages start at index 1. 1 => __('Field group updated.', 'acf'), 2 => __('Custom field updated.', 'acf'), 3 => __('Custom field deleted.', 'acf'), 4 => __('Field group updated.', 'acf'), /* translators: %s: date and time of the revision */ 5 => isset($_GET['revision']) ? sprintf( __('Field group restored to revision from %s', 'acf'), wp_post_revision_title( (int) $_GET['revision'], false ) ) : false, 6 => __('Field group published.', 'acf'), 7 => __('Field group saved.', 'acf'), 8 => __('Field group submitted.', 'acf'), 9 => __('Field group scheduled for.', 'acf'), 10 => __('Field group draft updated.', 'acf'), ); return $messages; } /*-------------------------------------------------------------------------------------- * * admin_head * * @author Elliot Condon * @since 1.0.0 * *-------------------------------------------------------------------------------------*/ function admin_head() { // hide upgrade page from nav echo ''; } /*-------------------------------------------------------------------------------------- * * get_field_groups * * This function returns an array of post objects found in the get_posts and the * register_field_group calls. * * @author Elliot Condon * @since 3.0.6 * *-------------------------------------------------------------------------------------*/ function get_field_groups() { // return cache $cache = $this->get_cache('acf_field_groups'); if($cache != false) { return $cache; } // vars $acfs = array(); // get acf's $result = get_posts(array( 'numberposts' => -1, 'post_type' => 'acf', 'orderby' => 'menu_order title', 'order' => 'asc', 'suppress_filters' => false, )); // populate acfs if($result) { foreach($result as $acf) { $acfs[] = array( 'id' => $acf->ID, 'title' => get_the_title($acf->ID), 'fields' => $this->get_acf_fields($acf->ID), 'location' => $this->get_acf_location($acf->ID), 'options' => $this->get_acf_options($acf->ID), 'menu_order' => $acf->menu_order, ); } } // hook to load in registered field groups $acfs = apply_filters('acf_register_field_group', $acfs); // update cache $this->set_cache('acf_field_groups', $acfs); // return if(empty($acfs)) { return false; } return $acfs; } /*-------------------------------------------------------------------------------------- * * get_acf_fields * - returns an array of fields for a acf object * * @author Elliot Condon * @since 1.0.0 * *-------------------------------------------------------------------------------------*/ function get_acf_fields($post_id) { // vars global $wpdb; $return = array(); // get field from postmeta $rows = $wpdb->get_results( $wpdb->prepare("SELECT meta_key FROM $wpdb->postmeta WHERE post_id = %d AND meta_key LIKE %s", $post_id, 'field\_%'), ARRAY_A); if( $rows ) { foreach( $rows as $row ) { $field = $this->get_acf_field( $row['meta_key'], $post_id ); $return[ $field['order_no'] ] = $field; } ksort($return); } // return return $return; } /*-------------------------------------------------------------------------------------- * * get_acf_field * - returns a field * - $post_id can be passed to make sure the correct field is loaded. Eg: a duplicated * field group may have the same field_key, but a different post_id * * @author Elliot Condon * @since 1.0.0 * *-------------------------------------------------------------------------------------*/ function get_acf_field( $field_key, $post_id = false ) { // return cache $cache = $this->get_cache('acf_field_' . $field_key); if($cache != false) { return $cache; } // vars global $wpdb; // get field from postmeta $sql = $wpdb->prepare("SELECT post_id, meta_value FROM $wpdb->postmeta WHERE meta_key = %s", $field_key); if( $post_id ) { $sql .= $wpdb->prepare("AND post_id = %d", $post_id); } $row = $wpdb->get_results( $sql, ARRAY_A ); if( $row ) { $row = $row[0]; // return field if it is not in a trashed field group if( get_post_status( $row['post_id'] ) != "trash" ) { $row['meta_value'] = maybe_unserialize( $row['meta_value'] ); $row['meta_value'] = maybe_unserialize( $row['meta_value'] ); // run again for WPML // store field $field = $row['meta_value']; // apply filters $field = apply_filters('acf_load_field', $field); $keys = array('type', 'name', 'key'); foreach( $keys as $key ) { if( isset($field[ $key ]) ) { $value = apply_filters('acf_load_field-' . $field[ $key ], $field); } } // set cache $this->set_cache('acf_field_' . $field_key, $field); return $field; } } // hook to load in registered field groups $acfs = $this->get_field_groups(); if($acfs) { // loop through acfs foreach($acfs as $acf) { // loop through fields if($acf['fields']) { foreach($acf['fields'] as $field) { if($field['key'] == $field_key) { // apply filters $field = apply_filters('acf_load_field', $field); $keys = array('type', 'name', 'key'); foreach( $keys as $key ) { if( isset($field[ $key ]) ) { $value = apply_filters('acf_load_field-' . $field[ $key ], $field); } } // set cache $this->set_cache('acf_field_' . $field_key, $field); return $field; } } } // if($acf['fields']) } // foreach($acfs as $acf) } // if($acfs) return null; } /* * acf_load_field_defaults * * @description: * @since 3.5.1 * @created: 14/10/12 */ function acf_load_field_defaults( $field ) { if( !is_array($field) ) { return $field; } $defaults = array( 'key' => '', 'label' => '', 'name' => '', 'type' => 'text', 'order_no' => '1', 'instructions' => '', 'required' => '0', 'conditional_logic' => array( 'status' => '0', 'allorany' => 'all', 'rules' => false ), ); $field = array_merge($defaults, $field); return $field; } /*-------------------------------------------------------------------------------------- * * create_field * * @author Elliot Condon * @since 1.0.0 * *-------------------------------------------------------------------------------------*/ function create_field($field) { if(!isset($this->fields[$field['type']]) || !is_object($this->fields[$field['type']])) { _e('Error: Field Type does not exist!','acf'); return false; } // defaults - class if( !isset($field['class']) ) { $field['class'] = $field['type']; } // defaults - id // - isset is needed for the edit field group page where fields are created without many parameters if( !isset($field['id']) ) { if( isset($field['key']) ) { $field['id'] = 'acf-' . $field['key']; } else { $field['id'] = 'acf-' . $field['name']; } } $this->fields[ $field['type'] ]->create_field($field); // conditional logic // - isset is needed for the edit field group page where fields are created without many parameters if( isset($field['conditional_logic']) && $field['conditional_logic']['status'] == '1' ): $join = ' && '; if( $field['conditional_logic']['allorany'] == "any" ) { $join = ' || '; } ?> array(), 'allorany' => 'all', ); // vars $allorany = get_post_meta($post_id, 'allorany', true); if( $allorany ) { $return['allorany'] = $allorany; } // get all fields $rules = get_post_meta($post_id, 'rule', false); if($rules) { foreach($rules as $rule) { // if field group was duplicated, it may now be a serialized string! $rule = maybe_unserialize($rule); $return['rules'][$rule['order_no']] = $rule; } } // sort ksort($return['rules']); // return fields return $return; } /*-------------------------------------------------------------------------------------- * * get_acf_options * * @author Elliot Condon * @since 1.0.0 * *-------------------------------------------------------------------------------------*/ function get_acf_options($post_id) { // defaults $options = array( 'position' => 'normal', 'layout' => 'no_box', 'hide_on_screen' => array(), ); // vars $position = get_post_meta($post_id, 'position', true); if( $position ) { $options['position'] = $position; } $layout = get_post_meta($post_id, 'layout', true); if( $layout ) { $options['layout'] = $layout; } $hide_on_screen = get_post_meta($post_id, 'hide_on_screen', true); if( $hide_on_screen ) { $hide_on_screen = maybe_unserialize($hide_on_screen); $options['hide_on_screen'] = $hide_on_screen; } // return return $options; } /*-------------------------------------------------------------------------------------- * * get_value * * @author Elliot Condon * @since 3.0.0 * *-------------------------------------------------------------------------------------*/ function get_value($post_id, $field) { if( empty($this->fields) ) { $this->setup_fields(); } if( !isset($field['type'], $this->fields[ $field['type'] ]) ) { return false; } return $this->fields[$field['type']]->get_value($post_id, $field); } /*-------------------------------------------------------------------------------------- * * get_value_for_api * * @author Elliot Condon * @since 3.0.0 * *-------------------------------------------------------------------------------------*/ function get_value_for_api($post_id, $field) { if( empty($this->fields) ) { $this->setup_fields(); } if( !isset($field['type'], $this->fields[ $field['type'] ]) ) { return false; } return $this->fields[$field['type']]->get_value_for_api($post_id, $field); } /*-------------------------------------------------------------------------------------- * * update_value * * @author Elliot Condon * @since 3.0.0 * *-------------------------------------------------------------------------------------*/ function update_value($post_id, $field, $value) { if( isset($field['type'], $this->fields[ $field['type'] ]) ) { $this->fields[$field['type']]->update_value($post_id, $field, $value); } } /*-------------------------------------------------------------------------------------- * * format_value_for_api * * @author Elliot Condon * @since 3.0.0 * *-------------------------------------------------------------------------------------*/ function format_value_for_api($value, $field) { return $this->fields[$field['type']]->format_value_for_api($value, $field); } /*-------------------------------------------------------------------------------------- * * create_format_data * * @author Elliot Condon * @since 3.0.0 * *-------------------------------------------------------------------------------------*/ function create_format_data($field) { return $this->fields[$field['type']]->create_format_data($field); } /* * render_fields_for_input * * @description: * @since 3.1.6 * @created: 23/06/12 */ function render_fields_for_input($fields, $post_id) { // create fields if($fields) { foreach($fields as $field) { // if they didn't select a type, skip this field if(!$field['type'] || $field['type'] == 'null') continue; // set value if( ! isset($field['value']) ) { $field['value'] = $this->get_value($post_id, $field); } $required_class = ""; $required_label = ""; if($field['required'] == "1") { $required_class = ' required'; $required_label = ' *'; } echo '
'; echo ''; echo $field['instructions']; echo '
'; $field['name'] = 'fields[' . $field['key'] . ']'; $this->create_field($field); echo '