version = 'v' . ACFFA_MAJOR_VERSION; $this->name = 'font-awesome'; $this->label = __( 'Font Awesome Icon', 'acf-font-awesome'); $this->category = 'content'; $this->settings = $settings; $this->defaults = array( 'enqueue_fa' => 0, 'allow_null' => 0, 'show_preview' => 1, 'save_format' => 'element', 'default_value' => '', 'default_label' => '', 'fa_live_preview' => '', 'choices' => array() ); parent::__construct(); if ( apply_filters( 'ACFFA_always_enqueue_fa', false ) ) { add_action( 'wp_enqueue_scripts', array( $this, 'frontend_enqueue_scripts' ) ); } else { add_filter('acf/load_field', array( $this, 'maybe_enqueue_font_awesome' ) ); } } private function get_icons( $format = 'list' ) { if ( ! $this->icons ) { $this->icons = apply_filters( 'ACFFA_get_icons', array() ); } return $this->icons[ $format ]; } private function get_fa_url() { return apply_filters( 'ACFFA_get_fa_url', '' ); } public function render_field_settings( $field ) { $icon_sets_args = array( 'label' => __( 'Icon Sets', 'acf-font-awesome' ), 'instructions' => __( 'Specify which icon set(s) to load', 'acf-font-awesome' ), 'type' => 'checkbox', 'name' => 'icon_sets', 'value' => ! empty( $field['icon_sets'] ) ? $field['icon_sets'][0] : 'far' ); if ( version_compare( ACFFA_MAJOR_VERSION, 5, '>=' ) ) { $icon_sets_args['choices'] = array( 'fas' => __( 'Solid', 'acf-font-awesome' ), 'far' => __( 'Regular', 'acf-font-awesome' ), 'fal' => __( 'Light (FontAwesome Pro License Required)', 'acf-font-awesome' ), 'fab' => __( 'Brands', 'acf-font-awesome' ), 'custom' => __( 'Custom Icon Set', 'acf-font-awesome' ) ); } else { $icon_sets_args['choices'] = array( 'all' => __( 'All Icons', 'acf-font-awesome' ), 'custom' => __( 'Custom Icon Set', 'acf-font-awesome' ) ); } acf_render_field_setting( $field, $icon_sets_args ); $custom_icon_set_choices = get_option( 'ACFFA_custom_icon_sets_list' ); if ( isset( $custom_icon_set_choices[ $this->version ] ) && ! empty( $custom_icon_set_choices[ $this->version ] ) ) { $custom_icon_set_choices = $custom_icon_set_choices[ $this->version ]; } else { $custom_icon_set_choices = array( __( 'No custom icon set(s) found', 'acf-font-awesome' ) ); } acf_render_field_setting( $field, array( 'label' => __( 'Custom Icon Set', 'acf-font-awesome' ), 'instructions' => sprintf( __( 'Create custom icon sets in the FontAwesome Settings page.', 'acf-font-awesome' ), admin_url( '/edit.php?post_type=acf-field-group&page=fontawesome-settings' ) ), 'type' => 'select', 'name' => 'custom_icon_set', 'class' => 'custom-icon-set', 'choices' => $custom_icon_set_choices, 'value' => isset( $field['custom_icon_set'] ) ? $field['custom_icon_set'] : false, 'placeholder' => 'Choose an icon set', 'allow_null' => 1 )); acf_render_field_setting( $field, array( 'label' => __( 'Icon Preview', 'acf-font-awesome' ), 'instructions' => '', 'type' => 'message', 'name' => 'fa_live_preview', 'class' => 'live-preview' )); acf_render_field_setting( $field, array( 'label' => __( 'Default Label', 'acf-font-awesome' ), 'instructions' => 'Used internally to store the select label for the default icon. For performance reasons.', 'type' => 'text', 'name' => 'default_label', 'value' => ! empty ( $field['default_label'] ) ? $field['default_label'] : $field['default_value'], 'class' => 'default_value' )); acf_render_field_setting( $field, array( 'label' => __( 'Default Icon', 'acf-font-awesome' ), 'instructions' => '', 'type' => 'select', 'name' => 'default_value', 'class' => 'select2-fontawesome fontawesome-create', 'choices' => ! empty( $field['default_label'] ) ? array( $field['default_value'] => html_entity_decode( $field['default_label'] ) ) : array( $field['default_value'] => $field['default_value'] ), 'value' => $field['default_value'], 'placeholder' => 'Choose a default icon (optional)', 'ui' => 1, 'allow_null' => 1, 'ajax' => 1, 'ajax_action' => 'acf/fields/font-awesome/query' )); acf_render_field_setting( $field, array( 'label' => __( 'Return Value', 'acf-font-awesome' ), 'instructions' => __( 'Specify the returned value on front end', 'acf-font-awesome' ), 'type' => 'radio', 'name' => 'save_format', 'choices' => array( 'element' => __( 'Icon Element', 'acf-font-awesome' ), 'class' => __( 'Icon Class', 'acf-font-awesome' ), 'unicode' => __( 'Icon Unicode', 'acf-font-awesome' ), 'object' => __( 'Icon Object', 'acf-font-awesome' ), ) )); acf_render_field_setting( $field, array( 'label' => __( 'Allow Null?', 'acf-font-awesome' ), 'instructions' => '', 'type' => 'radio', 'name' => 'allow_null', 'choices' => array( 1 => __( 'Yes', 'acf-font-awesome' ), 0 => __( 'No', 'acf-font-awesome' ) ) )); acf_render_field_setting( $field, array( 'label' => __( 'Show Icon Preview', 'acf-font-awesome' ), 'instructions' => __( 'Set to \'Yes\' to include a larger icon preview on any admin pages using this field.', 'acf-font-awesome' ), 'type' => 'radio', 'name' => 'show_preview', 'choices' => array( 1 => __( 'Yes', 'acf-font-awesome' ), 0 => __( 'No', 'acf-font-awesome' ) ) )); if ( ! apply_filters( 'ACFFA_always_enqueue_fa', false ) ) { acf_render_field_setting( $field, array( 'label' => __( 'Enqueue FontAwesome?', 'acf-font-awesome' ), 'instructions' => __( 'Set to \'Yes\' to enqueue FA in the footer on any pages using this field.', 'acf-font-awesome' ), 'type' => 'radio', 'name' => 'enqueue_fa', 'choices' => array( 1 => __( 'Yes', 'acf-font-awesome' ), 0 => __( 'No', 'acf-font-awesome' ) ) )); } } public function render_field( $field ) { $select2_class = version_compare( ACFFA_MAJOR_VERSION, 5, '>=' ) ? 'fa5' : 'fa4'; if ( $field['allow_null'] ) { $select_value = $field['value']; } else { $select_value = ( 'null' != $field['value'] ) ? $field['value'] : $field['default_value']; } $field['type'] = 'select'; $field['ui'] = 1; $field['ajax'] = 1; $field['choices'] = array(); $field['multiple'] = false; $field['class'] = $select2_class . ' select2-fontawesome fontawesome-edit'; $icons = $this->get_icons('list'); if ( version_compare( ACFFA_MAJOR_VERSION, 5, '<' ) ) : if ( $select_value && isset( $icons[ $select_value ] ) ) : $field['choices'][ $select_value ] = $icons[ $select_value ]; elseif ( ( ! $select_value || ! isset( $icons[ $select_value ] ) ) && ! $field['allow_null'] ) : $default_value = reset( $icons ); $default_key = key( $icons ); $field['choices'][ $default_key ] = $default_value; endif; else : $prefix = substr( $select_value, 0, 3 ); if ( $select_value && isset( $icons[ $prefix ][ $select_value ] ) ) : $field['choices'][ $select_value ] = htmlentities( $icons[ $prefix ][ $select_value ] ); elseif ( ( ! $select_value || ! isset( $icons[ $prefix ][ $select_value ] ) ) && ! $field['allow_null'] ) : $default_style_value = reset( $icons ); $default_style_key = key( $icons ); $default_value = reset( $default_style_value ); $default_key = key( $default_style_value ); $field['choices'][ $default_key ] = $default_value; endif; endif; acf_render_field( $field ); } public function input_admin_enqueue_scripts() { $url = $this->settings['url']; $version = $this->settings['version']; wp_register_script( 'acf-input-font-awesome', "{$url}assets/js/input-v5.js", array('acf-input'), $version ); wp_localize_script( 'acf-input-font-awesome', 'ACFFA', array( 'major_version' => ACFFA_MAJOR_VERSION )); wp_enqueue_script('acf-input-font-awesome'); wp_register_style( 'acf-input-font-awesome', "{$url}assets/css/input.css", array('acf-input'), $version ); wp_enqueue_style('acf-input-font-awesome'); if ( apply_filters( 'ACFFA_admin_enqueue_fa', true ) ) { wp_register_style( 'acf-input-font-awesome_library', $this->get_fa_url(), array('acf-input') ); wp_enqueue_style('acf-input-font-awesome_library'); } } public function maybe_enqueue_font_awesome( $field ) { if ( 'font-awesome' == $field['type'] && $field['enqueue_fa'] ) { add_action( 'wp_footer', array( $this, 'frontend_enqueue_scripts' ) ); } return $field; } public function frontend_enqueue_scripts() { wp_register_style( 'font-awesome', $this->get_fa_url() ); wp_enqueue_style('font-awesome'); } public function format_value( $value, $post_id, $field ) { if ( 'null' == $value ) { return false; } if ( empty( $value ) ) { return $value; } if ( ! $this->icons ) { $this->get_icons(); } if ( version_compare( ACFFA_MAJOR_VERSION, 5, '<' ) ) { $icon = isset( $this->icons['details'][ $value ] ) ? $this->icons['details'][ $value ] : false; } else { $prefix = substr( $value, 0, 3 ); $icon = isset( $this->icons['details'][ $prefix ][ $value ] ) ? $this->icons['details'][ $prefix ][ $value ] : false; } if ( $icon ) { switch ( $field['save_format'] ) { case 'element': if ( version_compare( ACFFA_MAJOR_VERSION, 5, '<' ) ) { $value = ''; } else { $value = ''; } break; case 'unicode': $value = $icon['unicode']; break; case 'object': $object_data = array( 'element' => '', 'class' => $value, 'hex' => $icon['hex'], 'unicode' => $icon['unicode'] ); if ( version_compare( ACFFA_MAJOR_VERSION, 5, '>=' ) ) { $object_data['prefix'] = $prefix; } $value = ( object ) $object_data; break; } } return $value; } } new acf_field_font_awesome( $this->settings ); endif;