plugin_dir_path( string $file )
Get the filesystem directory path (with trailing slash) for the plugin __FILE__ passed in.
Description
Parameters
- $file
-
(string) (Required) The filename of the plugin (__FILE__).
Return
(string) the filesystem path of the directory that contains the plugin.
Source
File: wp-includes/plugin.php
function plugin_dir_path( $file ) {
return trailingslashit( dirname( $file ) );
}
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |
More Information
It is a wrapper for trailingslashit( dirname( $file ) );.
The “plugin” part of the name is misleading – it can be used for any file, and will not return the directory of a plugin unless you call it within a file in the plugin’s base directory.
Including all PHP files from a plugin sub folder and avoiding adding a unnecessary global just to determine a path that is already available everywhere just using WP core functions.
foreach ( glob( plugin_dir_path( __FILE__ ) . "subfolder/*.php" ) as $file ) { include_once $file; }If you want the get the path one level up from the current dir, you can do
Get the directory of the current file:
Define path constant
For calling numerous files, it is sometimes convenient to define a constant:
Conditional loading
It is sometimes efficient to conditionally load files, e.g., admin-only (or even by specific admin screen):
if ( is_admin() ) { include_once( plugin_dir_path( __FILE__ ) . 'includes/admin-functions.php' ); } else { include_once( plugin_dir_path( __FILE__ ) . 'includes/front-end-functions.php' ); }if ( is_admin() ) { include_once( plugin_dir_path( __FILE__ ) . 'includes/admin-functions.php' ); } else { include_once( plugin_dir_path( __FILE__ ) . 'includes/front-end-functions.php' ); }