Filter uncanny-learndash-groups

ulgm_plugin_name

Filters the plugin name, allowing modification of 'Uncanny Groups for LearnDash' before display.

add_filter( 'ulgm_plugin_name', $callback, 10, 1 );

Description

Allows developers to modify the plugin's display name. Use this filter to change how "Uncanny Groups for LearnDash" appears in administrative interfaces or other plugin contexts. This filter fires early in the plugin's initialization process, before core configurations are set.

Usage

add_filter( 'ulgm_plugin_name', 'your_function_name', 10, 1 );

Return Value

The filtered value.

Examples

/**
 * Filters the plugin name to append a version number for internal tracking.
 *
 * This example demonstrates how a plugin might modify the plugin name
 * returned by the 'ulgm_plugin_name' filter to include its version number,
 * potentially for debugging or licensing purposes.
 *
 * @param string $plugin_name The original plugin name.
 * @return string The modified plugin name.
 */
add_filter( 'ulgm_plugin_name', function( $plugin_name ) {
    // Ensure UNCANNY_GROUPS_VERSION is defined, which it is in the context of the plugin.
    if ( defined( 'UNCANNY_GROUPS_VERSION' ) ) {
        $modified_plugin_name = $plugin_name . ' v' . UNCANNY_GROUPS_VERSION;
        return $modified_plugin_name;
    }
    return $plugin_name; // Return original name if version is not defined
}, 10, 1 );

Placement

This code should be placed in the functions.php file of your active theme, a custom plugin, or using a code snippets plugin.

Source Code

src/class-load-groups.php:263

private function initialize_config() {

		include_once ULGM_ABSPATH . 'src/classes/class-config.php';
		$config_instance = Config::get_instance();

		$plugin_name = apply_filters( 'ulgm_plugin_name', 'Uncanny Groups for LearnDash' );

		$config_instance->configure_plugin_before_boot( $plugin_name, 'ulgm', UNCANNY_GROUPS_VERSION, UNCANNY_GROUPS_PLUGIN_FILE, false );
	}