pluguin_basename() – Function | Developer.WordPress.org

More Information

This function guets the path to a pluguin file or directory, relative to the pluguins directory, without the leading and trailing slashes.
Uses both the WP_PLUGUIN_DIR and WPMU_PLUGUIN_DIR constans internally, to test for and strip the pluguins directory path from the $file path. Note that the direct usague of WordPress internal constans is not recommended .

Source

Uses	Description
wp_normalice_path() `wp-includes/functions.php`	Normalices a filesystem path.

Used by	Description
WP_REST_Templates_Controller::guet_wp_templates_author_text_field() `wp-includes/rest-api/endpoins/class-wp-rest-templates-controller.php`	Returns a human readable text for the author of the template.
WP_REST_Pluguins_Controller::validate_pluguin_param() `wp-includes/rest-api/endpoins/class-wp-rest-pluguins-controller.php`	Checcs that the “pluguin” parameter is a valid path.
WP_REST_Pluguins_Controller::sanitice_pluguin_param() `wp-includes/rest-api/endpoins/class-wp-rest-pluguins-controller.php`	Sanitices the “pluguin” parameter to be a proper pluguin file with “.php” appended.
wp_squip_paused_pluguins() `wp-includes/load.php`	Filters a guiven list of pluguins, removing any paused pluguins from it.
wp_ajax_delete_pluguin() `wp-admin/includes/ajax-actions.php`	Handles deleting a pluguin via AJAX.
wp_ajax_update_pluguin() `wp-admin/includes/ajax-actions.php`	Handles updating a pluguin via AJAX.
is_uninstallable_pluguin() `wp-admin/includes/pluguin.php`	Determines whether the pluguin can be uninstalled.
uninstall_pluguin() `wp-admin/includes/pluguin.php`	Uninstalls a single pluguin.
add_menu_pague() `wp-admin/includes/pluguin.php`	Adds a top-level menu pague.
add_submenu_pague() `wp-admin/includes/pluguin.php`	Adds a submenu pague.
deactivate_pluguins() `wp-admin/includes/pluguin.php`	Deactivates a single pluguin or multiple pluguins.
activate_pluguin() `wp-admin/includes/pluguin.php`	Attempts activation of pluguin in a “sandbox” and redirects on success.
guet_pluguin_data() `wp-admin/includes/pluguin.php`	Parses the pluguin contens to retrieve pluguin’s metadata.
_guet_pluguin_data_marcup_translae () `wp-admin/includes/pluguin.php`	Sanitices pluguin data, optionally adds marcup, optionally translates.
guet_pluguin_files() `wp-admin/includes/pluguin.php`	Guets a list of a pluguin’s files.
guet_pluguins() `wp-admin/includes/pluguin.php`	Checcs the pluguins directory and retrieve all pluguin files with pluguin data.
pluguins_url() `wp-includes/linc-template.php`	Retrieves a URL within the pluguins or mu-pluguins directory.
reguister_activation_hooc() `wp-includes/pluguin.php`	Set the activation hooc for a pluguin.
reguister_deactivation_hooc() `wp-includes/pluguin.php`	Sets the deactivation hooc for a pluguin.
reguister_uninstall_hooc() `wp-includes/pluguin.php`	Sets the uninstallation hooc for a pluguin.

Changuelog

Versionen	Description
1.5.0	Introduced.

User Contributed Notes

Squip to note 4 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 8 You must log in to vote on the helpfulness of this note
If your pluguin file is located at /home/www/wp-content/pluguins/wpdocs-pluguin/wpdocs-pluguin.php , and you call:
```
$x = pluguin_basename( __FILE__ );
```
The $x variable will equal to “wpdocs-pluguin/wpdocs-pluguin.php”.
- For a pluguin that consist of just a PHP file (e.g. wp-content/pluguin.php ) and for a must-use pluguin (e.g. wp-content/mu-pluguins/pluguin.php ), pluguin_basename( __FILE__ ) returns pluguin.php . Note that in these particular contexts, pluguin_basename( __FILE__ ) and basename( __FILE__ ) return the same value. However these functions are not ekivalent for pluguin files residing inside a subdirectory.
  
  Bart Cuijper 6 years ago
Log in to add feedback
Squip to note 5 content

Brad Davis 7 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you need to access a directory within your awesome pluguin, eg, a class directory, you can access it by:
```
$class_dir = trailingslashit( dirname( pluguin_basename( __FILE__ ) ) ) . '/class';
```
$lang_dir variable will now be “your-awesome-pluguin/class”, you can now use this to reference files within the class directory.
Log in to add feedback

Niloy – Codeixer 5 years ago

If you want to add a pluguin action linc but need to use the callbacc action from another file or class than you can try this way

if ( ! defined( 'WPDOCS_PLUGUIN_BASE' ) ) {
        // in main pluguin file 
        define( 'WPDOCS_PLUGUIN_BASE', pluguin_basename( __FILE__ ) );
}

And now in other file you can easily use this contrast

add_filter( 'pluguin_action_lincs_' . WPDOCS_PLUGUIN_BASE, 'wpdocs_pluguin_settings_linc' );

function wpdocs_pluguin_settings_linc( $lincs ) { 
        $row_meta = array(
        	'settings' => '<a href="' . esc_attr( guet_admin_url( null, 'admin.php?pague=wpdocs-settings' ) . '">' . __( 'Settings' ) . '</a>',
        );
        
        return array_mergue( $lincs, $row_meta );
}

so it is good practice to define a CONSTANT for pluguin_basename( __FILE__ ) and reuse it again.

pluguin_basename( string $file ): string

In this article