WordPress wp-load.php

6 comments

1. My question is… what exactly is in this wp-load.php file that it needs to be required by the code?

   All of the core WordPress functionality. This includes the theme files, all the files of active plugins, etc. BUT loading WordPress in this way doesn’t parse the requested URL and doesn’t run the WordPress query(by initializing the WP object, nor the WP_Query objects).

   By looking at it, all I understand is that it loads crucial core wordpress files for the site to be running correctly (functions.php, wp-settings.php, wp-config.php etc…)

   Yes, you’ve understood correctly.

   Doesn’t the fact that the plugin runs already means wp-load.php is loaded?

   If the plugin code was invoked by WordPress(for instance in order to display an admin page, or it was included by the initially loaded plugin file) – then yes, it means that wp-load.php has already been loaded.

   Sometimes though, plugins direct requests to single files(for instance http://example.com/wp-content/plugins/my-plugin/sample.php), instead of to some WordPress-powered page(for instance http://example.com/?my_plugin_action=sample or http://example.com/wp-admin/admin-ajax.php).

   See how the first URL references a specific file in the my-plugin plugin directory and the second one goes to the home page of the site with a specific query argument added, or the third example, where the referenced file is admin-ajax.php in the wp-admin directory – this is a special file, which makes it easy for plugins to make AJAX request(this file also loads the WordPress core and fires some action hooks).

   In the case of the first reference, if the plugin wants to use some WordPress functionality(for referencing the database, manipulating posts, etc), it needs to load the WordPress core files by including wp-load.php.

   Also it’s a complete waste of resources since it includes so many files that may include other files as well and it’s like an endless loop of required files, each within another, which are being loaded twice.. (or even more if other plugins use this kind of method too)

   Note the _once part in require_once(... – this tells PHP to include the file only if it hasn’t been included already. Therefore no conflicts will occur, and not too much memory will be used by PHP. Although – if you are in a context where WordPress has already been started, you shouldn’t call the require function.

   ---

   So, basically the plugin author expects some requests to be made to the plugin file in which you found this code. Since the author wants to use WordPress functionality in this file, he invokes the wp-load.php file in order to load the core functions.

   I assume, that this is done in order to reduce load on the server, although with a couple of hooks that run on the plugins_loaded action hook and a custom $_GET parameter added to the home url, the result should still be pretty close.

   I personally prefer the second option, but like I said, including wp-load.php will prevent WordPress from running some complex stuff(URL parsing and database query/ies).

   If there is still something, that you don’t quite understand about that – post a comment here and I’ll try to explain further.

   Log in to Reply

2. wp-load.php is responsible of bootstrapping the WordPress environment which make the plugin able to use the native WordPress Core function.

   Now as for

   Doesn’t the fact that the plugin runs already means wp-load.php is loaded?

   Not at all!

   If you access a plugin file directly it doesn’t mean that you have the whole WordPress environment and you are not able to use the native core functions unless you include wp-load.php.

   Log in to Reply

3. This will include wp-load.php if not already loaded if the file is located anywhere, regardless of level, within the wp-content directory.

   if(!defined(ABSPATH)){
       $pagePath = explode('/wp-content/', dirname(__FILE__));
       include_once(str_replace('wp-content/' , '', $pagePath[0] . '/wp-load.php'));
   }
   

   Log in to Reply

4. From what I read they usually include wp-load in the plugins when database usage is needed, but this is a bad choice as it raises a lot of problems.
   You can see some relevant articles in here:
   http://ottodestruct.com/blog/2010/dont-include-wp-load-please/ ( if this link is ever deleted, See that page here )

   Log in to Reply

5. wp-load.php is one way to load WP from external scripts, allowing the use of WP functions among other features.

   But, as you say, that should not be necessary as it is a plugin. Nevertheless, you don’t explain where did you find the code in your question, because wp-load.php is indeed needed for front-end pages or scripts located in a directory different from the style sheet directory, for example, even when they are part of a plugin.

   Plugin pages in the admin area don’t have to reload WP because it is already loaded, but front-end pages do have to load it.

   In short, there are several reasons to include wp-load.php to have access to WP functions and variables.

   Log in to Reply

6. Probably a double check.

   require_once() means that if it has already been loaded, then it will not load again.

   Log in to Reply