Make WordPress Core

Changeset 57902


Ignore:
Timestamp:
04/01/2024 02:51:45 AM (7 weeks ago)
Author:
azaozz
Message:

Docs: Improve the docblock for _wp_filter_font_directory(). Remove the recommended use section as this is a private use only function.

Props peterwilsoncc, swissspidy, azaozz.
Fixes #60652.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/fonts.php

    r57878 r57902  
    141141
    142142/**
    143  * Returns the font directory for use by the font library.
    144  *
    145  * This function is a callback for the {@see 'upload_dir'} filter. It is not
    146  * intended to be called directly. Use wp_get_font_dir() instead.
    147  *
    148  * The function can be used when extending the font library to modify the upload
    149  * destination for font files via the upload_dir filter. The recommended way to
    150  * do this is:
    151  *
    152  * ```php
    153  * add_filter( 'upload_dir', '_wp_filter_font_directory' );
    154  * // Your code to upload or sideload a font file.
    155  * remove_filter( 'upload_dir', '_wp_filter_font_directory' );
    156  * ```
     143 * A callback function for use in the {@see 'upload_dir'} filter.
     144 *
     145 * This function is intended for internal use only and should not be used by plugins and themes.
     146 * Use wp_get_font_dir() instead.
    157147 *
    158148 * @since 6.5.0
Note: See TracChangeset for help on using the changeset viewer.