lol backups and old site first commit
This commit is contained in:
@@ -0,0 +1,216 @@
|
||||
<?php
|
||||
/**
|
||||
* Icons API: Icon registration and rendering helper functions.
|
||||
*
|
||||
* @package WordPress
|
||||
* @subpackage Icons
|
||||
* @since 7.1.0
|
||||
*/
|
||||
|
||||
/**
|
||||
* Registers a new icon collection.
|
||||
*
|
||||
* @since 7.1.0
|
||||
*
|
||||
* @param string $slug Icon collection slug.
|
||||
* @param array $args {
|
||||
* Arguments for registering an icon collection.
|
||||
*
|
||||
* @type string $label Required. A human-readable label for the icon collection.
|
||||
* @type string $description Optional. A human-readable description for the icon collection.
|
||||
* }
|
||||
* @return bool True if the icon collection was registered successfully, else false.
|
||||
*/
|
||||
function wp_register_icon_collection( $slug, $args ) {
|
||||
return WP_Icon_Collections_Registry::get_instance()->register( $slug, $args );
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregisters an icon collection.
|
||||
*
|
||||
* @since 7.1.0
|
||||
*
|
||||
* @param string $slug Icon collection slug.
|
||||
* @return bool True if the icon collection was unregistered successfully, else false.
|
||||
*/
|
||||
function wp_unregister_icon_collection( $slug ) {
|
||||
return WP_Icon_Collections_Registry::get_instance()->unregister( $slug );
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers a new icon.
|
||||
*
|
||||
* @since 7.1.0
|
||||
*
|
||||
* @param string $icon_name Namespaced icon name in the form "collection/icon-name"
|
||||
* (e.g. "my-plugin/arrow-left"). The "core" collection is
|
||||
* reserved for WordPress core icons; third-party code should
|
||||
* register icons under its own collection rather than the
|
||||
* "core" collection.
|
||||
* @param array $args {
|
||||
* List of properties for the icon.
|
||||
*
|
||||
* @type string $label Required. A human-readable label for the icon.
|
||||
* @type string $content Optional. SVG markup for the icon.
|
||||
* If not provided, the content will be retrieved from the `file_path` if set.
|
||||
* If both `content` and `file_path` are not set, the icon will not be registered.
|
||||
* @type string $file_path Optional. The full path to the file containing the icon content.
|
||||
* }
|
||||
* @return bool True if the icon was registered successfully, else false.
|
||||
*/
|
||||
function wp_register_icon( $icon_name, $args ) {
|
||||
return WP_Icons_Registry::get_instance()->register( $icon_name, $args );
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregisters an icon.
|
||||
*
|
||||
* @since 7.1.0
|
||||
*
|
||||
* @param string $icon_name Namespaced icon name in the form "collection/icon-name"
|
||||
* (e.g. "core/arrow-left").
|
||||
* @return bool True if the icon was unregistered successfully, else false.
|
||||
*/
|
||||
function wp_unregister_icon( $icon_name ) {
|
||||
return WP_Icons_Registry::get_instance()->unregister( $icon_name );
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the default icon collections.
|
||||
*
|
||||
* @since 7.1.0
|
||||
* @access private
|
||||
*/
|
||||
function _wp_register_default_icon_collections() {
|
||||
wp_register_icon_collection(
|
||||
'core',
|
||||
array(
|
||||
'label' => __( 'WordPress' ),
|
||||
'description' => __( 'Default icon collection.' ),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the default core icons from the manifest.
|
||||
*
|
||||
* @since 7.1.0
|
||||
* @access private
|
||||
*/
|
||||
function _wp_register_default_icons() {
|
||||
$icons_directory = ABSPATH . WPINC . '/images/icon-library/';
|
||||
$manifest_path = ABSPATH . WPINC . '/assets/icon-library-manifest.php';
|
||||
|
||||
if ( ! is_readable( $manifest_path ) ) {
|
||||
wp_trigger_error(
|
||||
__FUNCTION__,
|
||||
__( 'Core icon collection manifest is missing or unreadable.' )
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
$collection = include $manifest_path;
|
||||
|
||||
if ( empty( $collection ) ) {
|
||||
wp_trigger_error(
|
||||
__FUNCTION__,
|
||||
__( 'Core icon collection manifest is empty or invalid.' )
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $collection as $icon_name => $icon_data ) {
|
||||
if (
|
||||
empty( $icon_data['filePath'] )
|
||||
|| ! is_string( $icon_data['filePath'] )
|
||||
) {
|
||||
_doing_it_wrong(
|
||||
__FUNCTION__,
|
||||
__( 'Core icon collection manifest must provide a valid "filePath" for each icon.' ),
|
||||
'7.0.0'
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
wp_register_icon(
|
||||
'core/' . $icon_name,
|
||||
array(
|
||||
'label' => $icon_data['label'],
|
||||
'file_path' => $icons_directory . $icon_data['filePath'],
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the SVG markup for a registered icon.
|
||||
*
|
||||
* @since 7.1.0
|
||||
*
|
||||
* @param string $name The namespaced icon name (e.g. 'core/plus',
|
||||
* 'core/arrow-down', 'my-plugin/custom-icon').
|
||||
* @param array $args {
|
||||
* Optional. Arguments for the icon. Default empty array.
|
||||
*
|
||||
* @type int|null $size Width and height in pixels. Pass null to leave the
|
||||
* SVG's intrinsic dimensions untouched. Default 24.
|
||||
* @type string $class Additional CSS class names. Multiple classes may be
|
||||
* provided as a space-separated string. Default empty string.
|
||||
* @type string $label Accessible label. If provided, the SVG gets
|
||||
* role="img" and aria-label. If omitted, the SVG
|
||||
* gets aria-hidden="true" and focusable="false".
|
||||
* Default empty string.
|
||||
* }
|
||||
* @return string SVG markup for the icon, or empty string if not found.
|
||||
*/
|
||||
function wp_get_icon( $name, $args = array() ) {
|
||||
$icon = WP_Icons_Registry::get_instance()->get_registered_icon( $name );
|
||||
if ( is_null( $icon ) ) {
|
||||
return '';
|
||||
}
|
||||
|
||||
$svg = $icon['content'];
|
||||
if ( empty( $svg ) ) {
|
||||
return '';
|
||||
}
|
||||
|
||||
$args = wp_parse_args(
|
||||
$args,
|
||||
array(
|
||||
'size' => 24,
|
||||
'class' => '',
|
||||
'label' => '',
|
||||
)
|
||||
);
|
||||
|
||||
$processor = new WP_HTML_Tag_Processor( $svg );
|
||||
if ( ! $processor->next_tag( 'svg' ) ) {
|
||||
return '';
|
||||
}
|
||||
|
||||
if ( is_numeric( $args['size'] ) ) {
|
||||
$size = absint( $args['size'] );
|
||||
$processor->set_attribute( 'width', (string) $size );
|
||||
$processor->set_attribute( 'height', (string) $size );
|
||||
}
|
||||
|
||||
if ( ! empty( $args['class'] ) ) {
|
||||
foreach ( preg_split( '/\s+/', $args['class'], -1, PREG_SPLIT_NO_EMPTY ) as $class_name ) {
|
||||
$processor->add_class( $class_name );
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! empty( $args['label'] ) ) {
|
||||
$processor->set_attribute( 'role', 'img' );
|
||||
$processor->set_attribute( 'aria-label', $args['label'] );
|
||||
$processor->remove_attribute( 'aria-hidden' );
|
||||
$processor->remove_attribute( 'focusable' );
|
||||
} else {
|
||||
$processor->set_attribute( 'aria-hidden', 'true' );
|
||||
$processor->set_attribute( 'focusable', 'false' );
|
||||
$processor->remove_attribute( 'role' );
|
||||
$processor->remove_attribute( 'aria-label' );
|
||||
}
|
||||
|
||||
return $processor->get_updated_html();
|
||||
}
|
||||
Reference in New Issue
Block a user