compatibility
3 years ago
controls
3 years ago
pa-display-conditions
3 years ago
templates
3 years ago
acf-helper.php
3 years ago
addons-cross-cp.php
3 years ago
addons-integration.php
3 years ago
assets-manager.php
3 years ago
class-pa-core.php
3 years ago
class-premium-template-tags.php
3 years ago
helper-functions.php
3 years ago
live-editor-modal.php
3 years ago
module-base.php
3 years ago
pa-nav-menu-walker.php
3 years ago
acf-helper.php
235 lines
| 1 | <?php |
| 2 | /** |
| 3 | * ACF Handler |
| 4 | * |
| 5 | * Contains helper functions for ACF fields. |
| 6 | */ |
| 7 | |
| 8 | namespace PremiumAddons\Includes; |
| 9 | |
| 10 | if ( ! defined( 'ABSPATH' ) ) { |
| 11 | exit; // Exit if accessed directly. |
| 12 | } |
| 13 | |
| 14 | /** |
| 15 | * Class ACF_Helper. |
| 16 | */ |
| 17 | class ACF_Helper { |
| 18 | |
| 19 | /** |
| 20 | * Format Acf Options. |
| 21 | * |
| 22 | * @since 4.4.8 |
| 23 | * @access public |
| 24 | * |
| 25 | * @param array $posts query objects - available custom fields -. |
| 26 | * @param array $options display options. |
| 27 | * |
| 28 | * @return array $results formated control options. |
| 29 | */ |
| 30 | public static function format_acf_query_result( $posts, $options ) { |
| 31 | |
| 32 | $results = array(); |
| 33 | $show_type = $options['show_type']; |
| 34 | $show_field_type = $options['show_field_type']; |
| 35 | $show_group = $options['show_group']; |
| 36 | |
| 37 | foreach ( $posts as $post ) { |
| 38 | |
| 39 | $acf_settings = unserialize( $post->post_content, ['allowed_classes' => false] ); // TODO:: check for a safer method. |
| 40 | |
| 41 | $acf_type = $show_field_type ? ucwords( $acf_settings['type'] ) . ': ' : ''; |
| 42 | |
| 43 | if ( ! in_array( $acf_settings['type'], self::get_allowed_field_types( $options['field_type'] ), true ) ) { |
| 44 | continue; } |
| 45 | |
| 46 | $acf_group = $show_group ? ' ( ' . get_the_title( $post->post_parent ) . ' ) ' : ''; |
| 47 | |
| 48 | $option_label = $acf_type . $post->post_title . $acf_group; |
| 49 | |
| 50 | $results[ $post->post_name ] = $option_label; |
| 51 | } |
| 52 | |
| 53 | return $results; |
| 54 | } |
| 55 | |
| 56 | /** |
| 57 | * Get ACF Options Pages Ids. |
| 58 | * |
| 59 | * List of ids of all options pages registered. |
| 60 | * |
| 61 | * @access public |
| 62 | * @since 4.4.8 |
| 63 | * @return array $options_page_groups_ids pages id |
| 64 | */ |
| 65 | public static function get_acf_options_pages_ids() { |
| 66 | |
| 67 | $options_page_groups_ids = array(); |
| 68 | |
| 69 | if ( function_exists( 'acf_options_page' ) ) { |
| 70 | $pages = acf_options_page()->get_pages(); |
| 71 | |
| 72 | foreach ( $pages as $slug => $page ) { |
| 73 | $options_page_groups = acf_get_field_groups( |
| 74 | array( |
| 75 | 'options_page' => $slug, |
| 76 | ) |
| 77 | ); |
| 78 | |
| 79 | foreach ( $options_page_groups as $options_page_group ) { |
| 80 | $options_page_groups_ids[] = $options_page_group['ID']; |
| 81 | } |
| 82 | } |
| 83 | } |
| 84 | |
| 85 | return $options_page_groups_ids; |
| 86 | } |
| 87 | |
| 88 | /** |
| 89 | * Check if the ACF field is in an options page. |
| 90 | * |
| 91 | * @access public |
| 92 | * @since 4.4.8 |
| 93 | * |
| 94 | * @param int $parent field parent id. |
| 95 | * @return bool |
| 96 | */ |
| 97 | public static function in_option_page( $parent ) { |
| 98 | |
| 99 | $option_pgs_ids = self::get_acf_options_pages_ids(); |
| 100 | |
| 101 | return in_array( $parent, $option_pgs_ids, true ); |
| 102 | |
| 103 | } |
| 104 | |
| 105 | /** |
| 106 | * Returns allowed field types |
| 107 | * |
| 108 | * @access public |
| 109 | * @since 4.4.8 |
| 110 | * |
| 111 | * @param string $type field category. |
| 112 | * @return array |
| 113 | */ |
| 114 | public static function get_allowed_field_types( $type ) { |
| 115 | |
| 116 | $default_types = array( |
| 117 | 'textual' => array( |
| 118 | 'text', |
| 119 | 'textarea', |
| 120 | 'number', |
| 121 | 'range', |
| 122 | 'email', |
| 123 | 'url', |
| 124 | 'password', |
| 125 | 'wysiwyg', |
| 126 | ), |
| 127 | 'date' => array( |
| 128 | 'date_picker', |
| 129 | 'date_time_picker', |
| 130 | ), |
| 131 | 'choice' => array( |
| 132 | 'select', |
| 133 | 'checkbox', |
| 134 | 'radio', |
| 135 | ), |
| 136 | 'boolean' => array( |
| 137 | 'true_false', |
| 138 | ), |
| 139 | ); |
| 140 | |
| 141 | return $default_types[ $type ]; |
| 142 | } |
| 143 | |
| 144 | /** |
| 145 | * Format Acf Values into array ['val : lablel'] || ['val : val'] |
| 146 | * |
| 147 | * @access public |
| 148 | * @since 4.4.8 |
| 149 | * |
| 150 | * @param string $values acf choice field value/s. |
| 151 | * @param string $return_format acf field return format. |
| 152 | * @param boolean $is_radio true if the field is radio button. |
| 153 | * @param boolean $single_select true if the field is a select option and multiple value is disabled. |
| 154 | * |
| 155 | * @return array |
| 156 | */ |
| 157 | public static function format_acf_values( $values, $return_format, $is_radio, $single_select = false ) { |
| 158 | |
| 159 | $formated_values = array(); |
| 160 | |
| 161 | if ( $is_radio || $single_select ) { |
| 162 | |
| 163 | if ( 'array' === $return_format ) { |
| 164 | array_push( $formated_values, $values['value'] . ' : ' . $values['label'] ); |
| 165 | } else { |
| 166 | array_push( $formated_values, $values . ' : ' . $values ); |
| 167 | } |
| 168 | } else { |
| 169 | |
| 170 | $values = acf_decode_choices( $values ); |
| 171 | |
| 172 | foreach ( $values as $index => $value ) { |
| 173 | if ( 'array' === $return_format ) { |
| 174 | array_push( $formated_values, $value['value'] . ' : ' . $value['label'] ); |
| 175 | } else { |
| 176 | array_push( $formated_values, $value . ' : ' . $value ); |
| 177 | } |
| 178 | } |
| 179 | } |
| 180 | |
| 181 | return $formated_values; |
| 182 | } |
| 183 | |
| 184 | /** |
| 185 | * Get ACF field value. |
| 186 | * |
| 187 | * @access public |
| 188 | * @since 4.4.8 |
| 189 | * |
| 190 | * @param string $field_key acf key. |
| 191 | * @param int $parent acf parent id. |
| 192 | */ |
| 193 | public function get_acf_field_value( $field_key, $parent ) { |
| 194 | |
| 195 | if ( self::in_option_page( $parent ) ) { |
| 196 | |
| 197 | return get_field_object( $field_key, 'option' )['value']; |
| 198 | } else { |
| 199 | |
| 200 | if ( is_preview() ) { |
| 201 | add_filter( 'acf/pre_load_post_id', array( $this, 'fix_post_id_on_preview' ), 10, 2 ); |
| 202 | } |
| 203 | |
| 204 | return get_field_object( $field_key )['value']; |
| 205 | } |
| 206 | |
| 207 | } |
| 208 | |
| 209 | |
| 210 | /** |
| 211 | * Fix PostId conflict on Preview. |
| 212 | * |
| 213 | * @access public |
| 214 | * @since 4.4.8 |
| 215 | * |
| 216 | * @param null $null $null. |
| 217 | * @param int $post_id post id. |
| 218 | */ |
| 219 | public static function fix_post_id_on_preview( $null, $post_id ) { |
| 220 | |
| 221 | if ( is_preview() ) { |
| 222 | return get_the_ID(); |
| 223 | } else { |
| 224 | $acf_post_id = isset( $post_id->ID ) ? $post_id->ID : $post_id; |
| 225 | |
| 226 | if ( ! empty( $acf_post_id ) ) { |
| 227 | return $acf_post_id; |
| 228 | } else { |
| 229 | return $null; |
| 230 | } |
| 231 | } |
| 232 | } |
| 233 | |
| 234 | } |
| 235 |