acf_field_wysiwyg{}ACF 1.0

Использование

$acf_field_wysiwyg = new acf_field_wysiwyg();
// use class methods

Методы

  1. public acf_enqueue_uploader()
  2. public add_filters()
  3. public format_value( $value, $post_id, $field )
  4. public get_toolbars()
  5. public initialize()
  6. public render_field( $field )
  7. public render_field_settings( $field )

Код acf_field_wysiwyg{} ACF 5.10.2

<?php
class acf_field_wysiwyg extends acf_field {


	/*
	*  __construct
	*
	*  This function will setup the field type data
	*
	*  @type    function
	*  @date    5/03/2014
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function initialize() {

		// vars
		$this->name     = 'wysiwyg';
		$this->label    = __( 'Wysiwyg Editor', 'acf' );
		$this->category = 'content';
		$this->defaults = array(
			'tabs'          => 'all',
			'toolbar'       => 'full',
			'media_upload'  => 1,
			'default_value' => '',
			'delay'         => 0,
		);

		// add acf_the_content filters
		$this->add_filters();

		// actions
		add_action( 'acf/enqueue_uploader', array( $this, 'acf_enqueue_uploader' ) );
	}


	/*
	*  add_filters
	*
	*  This function will add filters to 'acf_the_content'
	*
	*  @type    function
	*  @date    20/09/2016
	*  @since   5.4.0
	*
	*  @param   n/a
	*  @return  n/a
	*/

	function add_filters() {

		// WordPress 5.5 introduced new function for applying image tags.
		$wp_filter_content_tags = function_exists( 'wp_filter_content_tags' ) ? 'wp_filter_content_tags' : 'wp_make_content_images_responsive';

		// Mimic filters added to "the_content" in "wp-includes/default-filters.php".
		add_filter( 'acf_the_content', 'capital_P_dangit', 11 );
		// add_filter( 'acf_the_content', 'do_blocks', 9 ); Not yet supported.
		add_filter( 'acf_the_content', 'wptexturize' );
		add_filter( 'acf_the_content', 'convert_smilies', 20 );
		add_filter( 'acf_the_content', 'wpautop' );
		add_filter( 'acf_the_content', 'shortcode_unautop' );
		// add_filter( 'acf_the_content', 'prepend_attachment' ); Causes double image on attachment page.
		add_filter( 'acf_the_content', $wp_filter_content_tags );
		add_filter( 'acf_the_content', 'do_shortcode', 11 );

		// Mimic filters added to "the_content" in "wp-includes/class-wp-embed.php"
		if ( isset( $GLOBALS['wp_embed'] ) ) {
			add_filter( 'acf_the_content', array( $GLOBALS['wp_embed'], 'run_shortcode' ), 8 );
			add_filter( 'acf_the_content', array( $GLOBALS['wp_embed'], 'autoembed' ), 8 );
		}
	}


	/*
	*  get_toolbars
	*
	*  This function will return an array of toolbars for the WYSIWYG field
	*
	*  @type    function
	*  @date    18/04/2014
	*  @since   5.0.0
	*
	*  @param   n/a
	*  @return  (array)
	*/

	function get_toolbars() {

		// vars
		$editor_id = 'acf_content';
		$toolbars  = array();

		// mce buttons (Full)
		$mce_buttons   = array( 'formatselect', 'bold', 'italic', 'bullist', 'numlist', 'blockquote', 'alignleft', 'aligncenter', 'alignright', 'link', 'wp_more', 'spellchecker', 'fullscreen', 'wp_adv' );
		$mce_buttons_2 = array( 'strikethrough', 'hr', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help' );

		// mce buttons (Basic)
		$teeny_mce_buttons = array( 'bold', 'italic', 'underline', 'blockquote', 'strikethrough', 'bullist', 'numlist', 'alignleft', 'aligncenter', 'alignright', 'undo', 'redo', 'link', 'fullscreen' );

		// WP < 4.7
		if ( acf_version_compare( 'wp', '<', '4.7' ) ) {

			$mce_buttons   = array( 'bold', 'italic', 'strikethrough', 'bullist', 'numlist', 'blockquote', 'hr', 'alignleft', 'aligncenter', 'alignright', 'link', 'unlink', 'wp_more', 'spellchecker', 'fullscreen', 'wp_adv' );
			$mce_buttons_2 = array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help' );
		}

		// Full
		$toolbars['Full'] = array(
			1 => apply_filters( 'mce_buttons', $mce_buttons, $editor_id ),
			2 => apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ),
			3 => apply_filters( 'mce_buttons_3', array(), $editor_id ),
			4 => apply_filters( 'mce_buttons_4', array(), $editor_id ),
		);

		// Basic
		$toolbars['Basic'] = array(
			1 => apply_filters( 'teeny_mce_buttons', $teeny_mce_buttons, $editor_id ),
		);

		// Filter for 3rd party
		$toolbars = apply_filters( 'acf/fields/wysiwyg/toolbars', $toolbars );

		// return
		return $toolbars;

	}


	/*
	*  acf_enqueue_uploader
	*
	*  Registers toolbars data for the WYSIWYG field.
	*
	*  @type    function
	*  @date    16/12/2015
	*  @since   5.3.2
	*
	*  @param   void
	*  @return  void
	*/

	function acf_enqueue_uploader() {

		// vars
		$data     = array();
		$toolbars = $this->get_toolbars();

		// loop
		if ( $toolbars ) {
			foreach ( $toolbars as $label => $rows ) {

				// vars
				$key = $label;
				$key = sanitize_title( $key );
				$key = str_replace( '-', '_', $key );

				// append
				$data[ $key ] = array();

				if ( $rows ) {
					foreach ( $rows as $i => $row ) {
						$data[ $key ][ $i ] = implode( ',', $row );
					}
				}
			}
		}

		// localize
		acf_localize_data(
			array(
				'toolbars' => $data,
			)
		);
	}

	/*
	*  render_field()
	*
	*  Create the HTML interface for your field
	*
	*  @param   $field - an array holding all the field's data
	*
	*  @type    action
	*  @since   3.6
	*  @date    23/01/13
	*/

	function render_field( $field ) {

		// enqueue
		acf_enqueue_uploader();

		// vars
		$id             = uniqid( 'acf-editor-' );
		$default_editor = 'html';
		$show_tabs      = true;

		// get height
		$height = acf_get_user_setting( 'wysiwyg_height', 300 );
		$height = max( $height, 300 ); // minimum height is 300

		// detect mode
		if ( ! user_can_richedit() ) {

			$show_tabs = false;

		} elseif ( $field['tabs'] == 'visual' ) {

			// case: visual tab only
			$default_editor = 'tinymce';
			$show_tabs      = false;

		} elseif ( $field['tabs'] == 'text' ) {

			// case: text tab only
			$show_tabs = false;

		} elseif ( wp_default_editor() == 'tinymce' ) {

			// case: both tabs
			$default_editor = 'tinymce';

		}

		// must be logged in to upload
		if ( ! current_user_can( 'upload_files' ) ) {

			$field['media_upload'] = 0;

		}

		// mode
		$switch_class = ( $default_editor === 'html' ) ? 'html-active' : 'tmce-active';

		// filter
		add_filter( 'acf_the_editor_content', 'format_for_editor', 10, 2 );
		$field['value'] = apply_filters( 'acf_the_editor_content', $field['value'], $default_editor );

		// attr
		$wrap = array(
			'id'           => 'wp-' . $id . '-wrap',
			'class'        => 'acf-editor-wrap wp-core-ui wp-editor-wrap ' . $switch_class,
			'data-toolbar' => $field['toolbar'],
		);

		// delay
		if ( $field['delay'] ) {
			$wrap['class'] .= ' delay';
		}

		// vars
		$textarea = acf_get_textarea_input(
			array(
				'id'    => $id,
				'class' => 'wp-editor-area',
				'name'  => $field['name'],
				'style' => $height ? "height:{$height}px;" : '',
				'value' => '%s',
			)
		);

		?>
	<div <?php acf_esc_attr_e( $wrap ); ?>>
		<div id="wp-<?php echo esc_attr( $id ); ?>-editor-tools" class="wp-editor-tools hide-if-no-js">
			<?php if ( $field['media_upload'] ) : ?>
			<div id="wp-<?php echo esc_attr( $id ); ?>-media-buttons" class="wp-media-buttons">
				<?php
				if ( ! function_exists( 'media_buttons' ) ) {
					require ABSPATH . 'wp-admin/includes/media.php';
				}
				do_action( 'media_buttons', $id );
				?>
			</div>
			<?php endif; ?>
				<?php if ( user_can_richedit() && $show_tabs ) : ?>
				<div class="wp-editor-tabs">
					<button id="<?php echo esc_attr( $id ); ?>-tmce" class="wp-switch-editor switch-tmce" data-wp-editor-id="<?php echo esc_attr( $id ); ?>" type="button"><?php echo __( 'Visual', 'acf' ); ?></button>
					<button id="<?php echo esc_attr( $id ); ?>-html" class="wp-switch-editor switch-html" data-wp-editor-id="<?php echo esc_attr( $id ); ?>" type="button"><?php echo _x( 'Text', 'Name for the Text editor tab (formerly HTML)', 'acf' ); ?></button>
				</div>
			<?php endif; ?>
		</div>
		<div id="wp-<?php echo esc_attr( $id ); ?>-editor-container" class="wp-editor-container">
				<?php if ( $field['delay'] ) : ?>
				<div class="acf-editor-toolbar"><?php _e( 'Click to initialize TinyMCE', 'acf' ); ?></div>
			<?php endif; ?>
				<?php printf( $textarea, $field['value'] ); ?>
		</div>
	</div>
		<?php

	}


	/*
	*  render_field_settings()
	*
	*  Create extra options for your field. This is rendered when editing a field.
	*  The value of $field['name'] can be used (like bellow) to save extra data to the $field
	*
	*  @type    action
	*  @since   3.6
	*  @date    23/01/13
	*
	*  @param   $field  - an array holding all the field's data
	*/

	function render_field_settings( $field ) {

		// vars
		$toolbars = $this->get_toolbars();
		$choices  = array();

		if ( ! empty( $toolbars ) ) {

			foreach ( $toolbars as $k => $v ) {

				$label = $k;
				$name  = sanitize_title( $label );
				$name  = str_replace( '-', '_', $name );

				$choices[ $name ] = $label;
			}
		}

		// default_value
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Default Value', 'acf' ),
				'instructions' => __( 'Appears when creating a new post', 'acf' ),
				'type'         => 'textarea',
				'name'         => 'default_value',
			)
		);

		// tabs
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Tabs', 'acf' ),
				'instructions' => '',
				'type'         => 'select',
				'name'         => 'tabs',
				'choices'      => array(
					'all'    => __( 'Visual & Text', 'acf' ),
					'visual' => __( 'Visual Only', 'acf' ),
					'text'   => __( 'Text Only', 'acf' ),
				),
			)
		);

		// toolbar
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Toolbar', 'acf' ),
				'instructions' => '',
				'type'         => 'select',
				'name'         => 'toolbar',
				'choices'      => $choices,
				'conditions'   => array(
					'field'    => 'tabs',
					'operator' => '!=',
					'value'    => 'text',
				),
			)
		);

		// media_upload
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Show Media Upload Buttons?', 'acf' ),
				'instructions' => '',
				'name'         => 'media_upload',
				'type'         => 'true_false',
				'ui'           => 1,
			)
		);

		// delay
		acf_render_field_setting(
			$field,
			array(
				'label'        => __( 'Delay initialization?', 'acf' ),
				'instructions' => __( 'TinyMCE will not be initialized until field is clicked', 'acf' ),
				'name'         => 'delay',
				'type'         => 'true_false',
				'ui'           => 1,
				'conditions'   => array(
					'field'    => 'tabs',
					'operator' => '!=',
					'value'    => 'text',
				),
			)
		);

	}


	/*
	*  format_value()
	*
	*  This filter is appied to the $value after it is loaded from the db and before it is returned to the template
	*
	*  @type    filter
	*  @since   3.6
	*  @date    23/01/13
	*
	*  @param   $value (mixed) the value which was loaded from the database
	*  @param   $post_id (mixed) the $post_id from which the value was loaded
	*  @param   $field (array) the field array holding all the field options
	*
	*  @return  $value (mixed) the modified value
	*/

	function format_value( $value, $post_id, $field ) {

		// bail early if no value
		if ( empty( $value ) ) {

			return $value;

		}

		// apply filters
		$value = apply_filters( 'acf_the_content', $value );

		// follow the_content function in /wp-includes/post-template.php
		$value = str_replace( ']]>', ']]&gt;', $value );

		return $value;
	}

}