/home/eigit/eurolab.mk/wp-content/plugins/genesis-custom-blocks/php/Deprecated.php
<?php
/**
 * Deprecated functions.
 *
 * Deprecated methods can also appear as functions here, with the format namespace__class__method().
 *
 * @see Genesis\CustomBlocks\ComponentAbstract->_call()
 *
 * @package   Genesis\CustomBlocks
 * @copyright Copyright(c) 2022, Genesis Custom Blocks
 * @license http://opensource.org/licenses/GPL-2.0 GNU General Public License, version 2 (GPL-2.0)
 */

use function Genesis\CustomBlocks\add_block;
use function Genesis\CustomBlocks\add_field;

/**
 * Show a PHP error to warn developers using deprecated functions.
 *
 * @param string $func        The function that was called.
 * @param string $version     The version of Genesis Custom Blocks that deprecated the function.
 * @param string $replacement The function that should have been called.
 */
function genesis_custom_blocks_deprecated_function( $func, $version, $replacement ) {
	_deprecated_function(
		// filter_var is used for sanitization here as it allows arrow functions ("->").
		filter_var(
			sprintf(
				// translators: A function name.
				__( 'Genesis Custom Blocks\'s %1$s', 'genesis-custom-blocks' ),
				$func
			)
		),
		esc_html( $version ),
		filter_var( $replacement )
	);
}

/**
 * Handle the deprecated block_lab_get_icons() function.
 *
 * @see \Genesis\CustomBlocks\Util->get_icons()
 *
 * @return array
 */
function block_lab_get_icons() {
	genesis_custom_blocks_deprecated_function( 'block_lab_get_icons', '1.3.5', 'genesis_custom_blocks()->get_icons()' );
	return [];
}

/**
 * Handle the deprecated block_lab_allowed_svg_tags() function.
 *
 * @see \Genesis\CustomBlocks\Util->allowed_svg_tags()
 *
 * @return array
 */
function block_lab_allowed_svg_tags() {
	genesis_custom_blocks_deprecated_function( 'block_lab_allowed_svg_tags', '1.3.5', 'genesis_custom_blocks()->allowed_svg_tags()' );
	return genesis_custom_blocks()->allowed_svg_tags();
}

/**
 * Handle deprecated block_lab_add_block function.
 *
 * @param string $block_name   The block name (slug), like 'example-block'.
 * @param array  $block_config An associative array containing the block configuration.
 */
function block_lab_add_block( $block_name, $block_config = [] ) {
	genesis_custom_blocks_deprecated_function( 'block_lab_add_block', '1.5.4', 'Genesis\\CustomBlocks\\add_block()' );
	add_block( $block_name, $block_config );
}

/**
 * Handle deprecated block_lab_add_field function.
 *
 * @param string $block_name   The block name (slug), like 'example-block'.
 * @param string $field_name   The field name (slug), like 'first-name'.
 * @param array  $field_config An associative array containing the field configuration.
 */
function block_lab_add_field( $block_name, $field_name, $field_config = [] ) {
	genesis_custom_blocks_deprecated_function( 'block_lab_add_field', '1.5.4', 'Genesis\\CustomBlocks\\add_field()' );
	add_field( $block_name, $field_name, $field_config );
}

/**
 * Prepare a loop with the first or next row in a repeater.
 *
 * @param string $name The name of the repeater field.
 */
function block_row( $name ) {
	unset( $name );
	_deprecated_function( 'block_row', '1.0.0' );
}

/**
 * Determine whether another repeater row exists to loop through.
 *
 * @param string $name The name of the repeater field.
 */
function block_rows( $name ) {
	unset( $name );
	_deprecated_function( 'block_rows', '1.0.0' );
}

/**
 * Resets the repeater block rows after the while loop.
 *
 * @param string $name The name of the repeater field.
 */
function reset_block_rows( $name ) {
	unset( $name );
	_deprecated_function( 'reset_block_rows', '1.0.0' );
}

/**
 * Return the total amount of rows in a repeater.
 *
 * @param string $name The name of the repeater field.
 */
function block_row_count( $name ) {
	unset( $name );
	_deprecated_function( 'block_row_count', '1.0.0' );
}

/**
 * Return the index of the current repeater row.
 *
 * @param string $name (Optional) The name of the repeater field.
 */
function block_row_index( $name = '' ) {
	unset( $name );
	_deprecated_function( 'block_row_index', '1.0.0' );
}

/**
 * Return the value of a sub-field.
 *
 * @param string $name The name of the sub-field.
 * @param bool   $is_echo Whether to echo and return the field, or just return the field.
 */
function block_sub_field( $name, $is_echo = true ) {
	unset( $name, $is_echo );
	_deprecated_function( 'block_sub_field', '1.0.0' );
}

/**
 * Return the value of a sub-field, without echoing it.
 *
 * @param string $name The name of the sub-field.
 */
function block_sub_value( $name ) {
	unset( $name );
	_deprecated_function( 'block_sub_value', '1.0.0' );
}