/**
 * @package ACF
 * @author  WP Engine
 *
 * © 2025 Advanced Custom Fields (ACF®). All rights reserved.
 * "ACF" is a trademark of WP Engine.
 * Licensed under the GNU General Public License v2 or later.
 * https://www.gnu.org/licenses/gpl-2.0.html
 */

/**
 * Process updating bidirectional fields.
 *
 * @since 6.2
 *
 * @param array          $target_item_ids The post, user or term IDs which should be updated with the origin item ID.
 * @param integer|string $post_id         The ACF encoded origin post, user or term ID.
 * @param array          $field           The field being updated on the origin post, user or term ID.
 * @param string|false   $target_prefix   The ACF prefix for a post, user or term ID required for the update_field call for this field type.
 */
function acf_update_bidirectional_values( $target_item_ids, $post_id, $field, $target_prefix = false ) {

	// Bail early if we're already updating a bidirectional relationship to prevent recursion.
	if ( acf_get_data( 'acf_doing_bidirectional_update' ) ) {
		return;
	}

	// Support disabling bidirectionality globally.
	if ( ! acf_get_setting( 'enable_bidirection' ) ) {
		return;
	}

	if ( empty( $field['bidirectional'] ) || empty( $field['bidirectional_target'] ) ) {
		return;
	}

	$decoded            = acf_decode_post_id( $post_id );
	$item_id            = $decoded['id'];
	$valid_target_types = acf_get_valid_bidirectional_target_types( $decoded['type'] );
	$valid_targets      = array();

	foreach ( $field['bidirectional_target'] as $target_field ) {
		$target_field_object = get_field_object( $target_field );
		if ( empty( $target_field_object ) || ! is_array( $target_field_object ) ) {
			continue;
		}
		if ( in_array( $target_field_object['type'], $valid_target_types, true ) ) {
			$valid_targets[] = $target_field;
		}
	}

	if ( ! empty( $valid_targets ) ) {

		// Get current values for this field.
		$current_values = array_filter( acf_get_array( get_field( $field['key'], $post_id, false ) ) );
		$new_values     = array_filter( acf_get_array( $target_item_ids ) );

		$additions    = array_diff( $new_values, $current_values );
		$subtractions = array_diff( $current_values, $new_values );

		// Prefix additions and subtractions for destinations which aren't posts.
		if ( ! empty( $target_prefix ) ) {
			$mapper       = function ( $v ) use ( $target_prefix ) {
				return $target_prefix . '_' . $v;
			};
			$additions    = array_map( $mapper, $additions );
			$subtractions = array_map( $mapper, $subtractions );
		}

		acf_set_data( 'acf_doing_bidirectional_update', true );

		// Loop over each target, processing additions and removals.
		foreach ( $valid_targets as $target_field ) {
			foreach ( $additions as $addition ) {
				$current_value = acf_get_array( get_field( $target_field, $addition, false ) );
				update_field( $target_field, array_unique( array_merge( $current_value, array( $item_id ) ) ), $addition );
			}

			foreach ( $subtractions as $subtraction ) {
				$current_value = acf_get_array( get_field( $target_field, $subtraction, false ) );
				update_field( $target_field, array_unique( array_diff( $current_value, array( $item_id ) ) ), $subtraction );
			}
		}

		acf_set_data( 'acf_doing_bidirectional_update', false );
	}
}

/**
 * Allows third party fields to enable support as a target field type for a particular object type
 *
 * @since 6.2
 *
 * @param string $object_type The object type that will be updated on the target field, such as 'term', 'user' or 'post'.
 *
 * @return array An array of valid field type names (slugs) for the target of the bidirectional field.
 */
function acf_get_valid_bidirectional_target_types( $object_type ) {
	$valid_target_types = array();
	switch ( $object_type ) {
		case 'term':
			$valid_target_types = array( 'taxonomy' );
			break;
		case 'user':
			$valid_target_types = array( 'user' );
			break;
		case 'post':
			$valid_target_types = array( 'relationship', 'post_object' );
			break;
	}
	return apply_filters( 'acf/bidirectional/supported_field_types_for_post', $valid_target_types, $object_type );
}

/**
 * Build the complete choices argument for rendering the select2 field for bidirectional target based on the currently selected choices
 *
 * @since 6.2
 *
 * @param array $choices The currently selected choices (as an array of field keys).
 *
 * @return array
 */
function acf_build_bidirectional_target_current_choices( $choices ) {
	if ( empty( $choices ) ) {
		return array();
	}

	$results = array();
	foreach ( $choices as $choice ) {
		if ( empty( $choice ) || ! is_string( $choice ) ) {
			continue;
		}

		$field_object = get_field_object( $choice );
		if ( is_array( $field_object ) && ! empty( $field_object['label'] ) ) {
			$results[ $choice ] = $field_object['label'];
		} else {
			$results[ $choice ] = $choice;
		}
	}

	return $results;
}

/**
 * Build valid fields for a bidirectional relationship for select2 display
 *
 * @since 6.2
 *
 * @param array $results The original results array.
 * @param array $options The options provided to the select2 AJAX search.
 *
 * @return array
 */
function acf_build_bidirectional_relationship_field_target_args( $results, $options ) {
	$valid_field_types = apply_filters( 'acf/bidirectional/supported_target_field_types', array( 'relationship', 'post_object', 'user', 'taxonomy' ) );

	$field_groups = array_filter(
		acf_get_field_groups(),
		function ( $field_group ) {
			return $field_group['active'];
		}
	);

	$valid_fields = array();
	foreach ( $field_groups as $field_group ) {
		$fields = acf_get_fields( $field_group );
		foreach ( $fields as $field ) {
			if ( in_array( $field['type'], $valid_field_types, true ) ) {
				if ( empty( $valid_fields[ $field_group['title'] ] ) ) {
					$valid_fields[ $field_group['title'] ] = array();
				}
				$valid_fields[ $field_group['title'] ][ $field['key'] ] = array(
					'type'  => $field['type'],
					'label' => $field['label'],
				);

				if ( isset( $options['parent_key'] ) && $options['parent_key'] === $field['key'] ) {
					$valid_fields[ $field_group['title'] ][ $field['key'] ]['this_field'] = true;
				}
			}
		}
	}

	foreach ( $valid_fields as $field_group_name => $fields ) {
		$field_group = array(
			'text'     => $field_group_name,
			'children' => array(),
		);
		foreach ( $fields as $key => $data ) {
			$field_group['children'][] = array(
				'id'               => $key,
				'text'             => $data['label'],
				'field_type'       => $data['type'],
				/* translators: %s A field type name, such as "Relationship" */
				'human_field_type' => sprintf( __( '%s Field', 'acf' ), acf_get_field_type_prop( $data['type'], 'label' ) ),
				'this_field'       => ! empty( $data['this_field'] ),
			);
		}
		$results['results'][] = $field_group;
	}

	return $results;
}

add_action( 'acf/fields/select/query/key=_acf_bidirectional_target', 'acf_build_bidirectional_relationship_field_target_args', 10, 2 );

/**
 * Renders the field settings required for bidirectional fields
 *
 * @since 6.2
 *
 * @param array $field The field object passed into field setting functions.
 */
function acf_render_bidirectional_field_settings( $field ) {
	if ( ! acf_get_setting( 'enable_bidirection' ) ) {
		return;
	}

	acf_render_field_setting(
		$field,
		array(
			'label'        => __( 'Bidirectional', 'acf' ),
			'instructions' => __( 'Update a field on the selected values, referencing back to this ID', 'acf' ),
			'type'         => 'true_false',
			'name'         => 'bidirectional',
			'ui'           => 1,
		)
	);

	acf_render_field_setting(
		$field,
		array(
			'name'       => 'bidirectional_notes',
			'type'       => 'message',
			'message'    => acf_get_bidirectional_field_settings_instruction_text(),
			'conditions' => array(
				'field'    => 'bidirectional',
				'operator' => '==',
				'value'    => 1,
			),
		)
	);

	acf_render_field_setting(
		$field,
		array(
			'type'         => 'select',
			'name'         => 'bidirectional_target',
			'label'        => __( 'Target Field', 'acf' ),
			'instructions' => __( 'Select field(s) to store the reference back to the item being updated. You may select this field. Target fields must be compatible with where this field is being displayed. For example, if this field is displayed on a Taxonomy, your target field should be of type Taxonomy', 'acf' ),
			'class'        => 'bidrectional_target',
			'choices'      => acf_build_bidirectional_target_current_choices( $field['bidirectional_target'] ),
			'conditions'   => array(
				'field'    => 'bidirectional',
				'operator' => '==',
				'value'    => 1,
			),
			'ui'           => 1,
			'multiple'     => 1,
			'ajax'         => 1,
		)
	);
}

/**
 * Returns the translated instructional text for the message field for the bidirectional field settings.
 *
 * @since 6.2
 *
 * @return string The html containing the instructional message.
 */
function acf_get_bidirectional_field_settings_instruction_text() {
	/* translators: %s the URL to ACF's bidirectional relationship documentation */
	$message = '<p class="acf-feature-notice with-warning-icon">' . sprintf( __( 'Enabling the bidirectional setting allows you to update a value in the target fields for each value selected for this field, adding or removing the Post ID, Taxonomy ID or User ID of the item being updated. For more information, please read the <a href="%s" target="_blank">documentation</a>.', 'acf' ), acf_add_url_utm_tags( 'https://www.advancedcustomfields.com/resources/bidirectional-relationships/', 'docs', 'bidirectional' ) ) . '</p>';
	return $message;
}
<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>commercial magic &#8211; Erdnase Magic Store</title>
	<atom:link href="https://erdnasemagicstore.io/product-tag/commercial-magic/feed/" rel="self" type="application/rss+xml" />
	<link>https://erdnasemagicstore.io</link>
	<description>Almost free :)</description>
	<lastBuildDate>Mon, 28 Oct 2024 14:11:57 +0000</lastBuildDate>
	<language>en-US</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	

<image>
	<url>https://erdnasemagicstore.io/wp-content/uploads/2023/11/sparkle_logo.svg</url>
	<title>commercial magic &#8211; Erdnase Magic Store</title>
	<link>https://erdnasemagicstore.io</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Billy McComb &#8211; The Professional Touch (official pdf)</title>
		<link>https://erdnasemagicstore.io/product/billy-mccomb-the-professional-touch-official-pdf/?utm_source=rss&#038;utm_medium=rss&#038;utm_campaign=billy-mccomb-the-professional-touch-official-pdf</link>
		
		<dc:creator><![CDATA[Single]]></dc:creator>
		<pubDate>Fri, 11 Jan 2019 00:00:00 +0000</pubDate>
				<guid isPermaLink="false">http://176.123.9.228/product/billy-mccomb-the-professional-touch-official-pdf/</guid>

					<description><![CDATA[My oh my is this a great ebook! If you intend to earn a living doing magic or if you simply want to make your performances more professional then do yourself a favor and read and study this ebook. There are decades of experience bottled up in its wisdom. And on top of this it [&#8230;]]]></description>
										<content:encoded><![CDATA[<p>My oh my is this a great ebook! If you intend to earn a living doing magic or if you simply want to make your performances more professional then do yourself a favor and read and study this ebook. There are decades of experience bottled up in its wisdom. And on top of this it is fun to read.</p>
<p>The ebook starts with a superb introduction by Kirk Charles reproduced with kind permission of the <cite>Linking Ring</cite>. The ebook is edited and illustrated by <a href="http://176.123.9.228/372"><u>David Britland</u></a> with extra illustrations by JAT. And Martin Breese is the publisher. It was also Martin who recorded on tape Billy&#8217;s recollections from which this book was largely created.</p>
<p>Billy McComb was one of the world&#8217;s top cabaret magicians. He has worked all kinds of venues and performed all kinds of magic and in this ebook he shares some of his many experiences, thoughts and routines and describes how you too can give the professional touch to your act. Being a professional means thinking about your act in a commercial way. Here Billy deals with such points as misdirection, patter, close-up, opening effects, cabaret &#8211; in fact a wealth of information gained during his many years as a professional entertainer.</p>
<p>Billy touches on so many varied and interesting subjects connected with show business that it is impossible to list them here. We can promise you that reading about them will be an entertaining and educational experience. In addition to the tricks and routines explained in this ebook, Billy has also included complete descriptions of three cabaret routines used by him for many years. Every nuance of the performance is explained. Not just how you do it but, more importantly, why you do it.</p>
<p>A study of these three routines and their construction should pay dividends when applied to your own act. This is professional magic by one of our most entertaining professionals. Amongst the routines and effects described you will find The Nap Hand routine, the Ring on Stick and Billy&#8217;s Bill in Lemon.</p>
<p><i>1st edition 1987; revised in 2003; digital edition 2010; 100 pages.</i></p>
<p>&nbsp;</p>
<div>
<p><b>Table of Contents</b></p>
<ol class="col2">
<li value="4">Contents</li>
<li value="7">Foreword</li>
<li value="8">Introduction<b>William&#8217;s Words of Wisdom</b></li>
<li value="11">What Are You Going to Wear?</li>
<li value="12">A Beginner&#8217;s Tricks<b>McComb on Patter</b></li>
<li value="14">Where the Patter Comes From</li>
<li value="14">Tape Recorders</li>
<li value="15">Timing and Pointing</li>
<li value="16">Keep It Clean</li>
<li value="16">Learning Your Patter</li>
<li value="17">Repetitive Gags</li>
<li value="18">Pinching Patter<b>McComb on Misdirection</b>
<p><b>McComb and the Professional Touch</b></li>
<li value="22">What Went Wrong?</li>
<li value="22">Signs of the Amateur</li>
<li value="23">Knowledge is the Key</li>
<li value="23">Working Out a Presentation</li>
<li value="23">The Rice Bowls</li>
<li value="25">William&#8217;s Torn and Restored Newspaper</li>
<li value="26">William&#8217;s Presentation Wand</li>
<li value="27">William&#8217;s Fantastic Fez</li>
<li value="28">William&#8217;s Hot Book</li>
<li value="28">William&#8217;s Square Dancing</li>
<li value="29">William&#8217;s Fizzling Firework</li>
<li value="30">The Eggs and Glasses Inertia Trick<b>McComb on Close-Up</b></li>
<li value="31">Introduction</li>
<li value="31">Cigarette Through Handkerchief</li>
<li value="33">The Shrinking Napkin</li>
<li value="34">Challenge Silk Vanish</li>
<li value="35">Oliver Mackenzie&#8217;s Drink Trick</li>
<li value="36">George Blake&#8217;s Recurring Card</li>
<li value="36">Thought on the Pea Can</li>
<li value="38">The End<b>McComb on Cruising</b>
<p><b>McComb on Opening Effects</b></li>
<li value="43">The Six Card Repeat</li>
<li value="44">Golf Ball Through Handkerchief</li>
<li value="44">The Torn and Restored Airmail Letter</li>
<li value="44"><a href="http://176.123.9.228/373"><u>Pat Page&#8217;s</u></a> Easy Money</li>
<li value="45">Leopard Silk</li>
<li value="46">Just Chance</li>
<li value="46">The Professor&#8217;s Nightmare</li>
<li value="47">Invisible Card Trick</li>
<li value="47">Red and White Ropes<b>McComb on Cabaret</b></li>
<li value="49">Be Bookable</li>
<li value="49">Dealing With Your Audience</li>
<li value="52">Humour</li>
<li value="52">Cleanliness</li>
<li value="53">Your Trademark Trick</li>
<li value="54">The Role of the Compère</li>
<li value="55">Get Organised</li>
<li value="55">Learn From Everyone</li>
<li value="55">Be Bold</li>
<li value="56">Cabaret Defined</li>
<li value="56">Contracts</li>
<li value="57">Travel Light</li>
<li value="58">Nerves</li>
<li value="58">Get Them to Relax</li>
<li value="58">Be Sneaky</li>
<li value="59">Salesmanship</li>
<li value="59">Heckler-Stoppers</li>
<li value="59">Please the Ladies</li>
<li value="59">What Is Right?</li>
<li value="60">Comments and Suggestions<b>The Professional Nap Hand</b></li>
<li value="63">Requirements</li>
<li value="65">Preparation</li>
<li value="65">Presentation</li>
<li value="70">Playing the Hands</li>
<li value="74">Final Comments</li>
<li value="75">References for Further Reading<b>The Professional Ring on Stick</b></li>
<li value="77">The Effect</li>
<li value="77">Introduction</li>
<li value="78">What You Need</li>
<li value="79">Preparation</li>
<li value="80">Presentation<b>The Professional Bill in the Lemon</b></li>
<li value="88">The Effect</li>
<li value="89">Method</li>
<li value="89">Requirements</li>
<li value="89">Preparation</li>
<li value="92">Forcing the Lemon</li>
<li value="93">Switching the Bills</li>
<li value="94">Vanishing the Bill</li>
<li value="95">Cutting the Lemon</li>
<li value="96">Revealing the Bill</li>
<li value="96">Where Everything Is Placed</li>
<li value="96">Presentation</li>
<li value="98">Patter</li>
<li value="99">Conclusion</li>
</ol>
<p><i>word count: 49221 which is equivalent to 196 standard pages of text</i></div>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>