extract pluggable.php function logic into separate functions

[wnorris]

Currently, when a plugin overrides one of the pluggable.php functions with a custom implementation, there is no way to fall back to the standard version of the function. Instead, plugin authors have to copy and paste all of the logic from pluggable.php into their custom function. I'd love to see the actual logic separated out into "private" functions that are simply called the public ones. For example:

if (!function_exists('wp_get_current_user')) {
    function wp_get_current_user() {
        return _wp_get_current_user();
    }
}

function _wp_get_current_user() {
    /* normal logic for getting the current user */
}

This would allow me to override the function, but still fallback to the standard implementation if I need to...

if (!function_exists('wp_get_current_user')) {
    function wp_get_current_user() {
        if ( /* some condition */ ) {
            /* my own custom get current user logic */
        } else {
            return _wp_get_current_user();
        }
    }
}

This wouldn't actually take that much work, and I'm happy to do it. Not sure if it would be best to keep it all in pluggable.php, or if the standard implementations should be moved to pluggable.standard.php or something similar. ??

Original wp-hackers thread: ​http://groups.google.com/group/wp-hackers/browse_thread/thread/31295f83a13dc025

In fact, this is very similar to how set_current_user() already works... it's simply a wrapper that calls wp_set_current_user(). The only problem with this one in particular, is that all the other functions in pluggable.php call wp_set_current_user directly, instead of calling the wrapper function (elsewhere in WordPress, most of the code correctly calls the wrapper function). It's the right idea, just needs to be cleaned up.

As I said on the wp-hackers list, this is an elegant idea. It's essentially the procedural programming eqivalent to being able to call a super() function in OOP. Well, sort of :)

A great way to provide the ability to override functionality, but allowing a fallback to the original function when needed, without sacrificing forward compatibility.

I think you can put the standard implementations in the appropriate include files. User and login stuff in user.php, for example.

I like this, a lot.

Someone needs to like it enough to patch it. :-)

Replying to ryan:

Someone needs to like it enough to patch it. :-)

Okay. :)

First pass, needs through testing and phpDoc feedback

Very minor phpdocs fix (had periods instead of spaces)

A summary of my patch:

1. I took the original function (along with all of it's phpDocs) and copy/pasted it into another file.

2. Prefixed the new function name with an underscore and changed @since to 2.8.0 since it's a new function.

3. Added the following after all of the description and before the @since:

 * This function should not be used directly. Use the pluggable version instead.
 * @see pluggable_function()

4. Went back to the original function in pluggable.php and stripped out it's contents, replacing it with the new internal function.

5. Removed any @uses since the pluggable function no longer actually used them (they're still over with the new internal function though). Also removed any description bits specific to that implementation of the plugin function but that weren't generic descriptors of what the function should do.

6. Added the following after the description and before @since:

 * @see _pluggable_function()

Note I did not add a @uses _pluggable_function() which is one of my questions (is that needed in addition to or instead of the @uses?).

Please leave any and all feedback.

Figures I read the wp-hackers thread after I spend over 2 hours writing the above patch. Bah.

Maybe current patch now with a possible switch to filter based replacements later.

Figures I read the wp-hackers thread after I spend over 2 hours writing the above patch

Not to worry. I think theres even a Trac ticket for it.

This'd have to be done anyway.. so that the pluggable functions were just a return apply_filters(__FUNCTION__, false);

Replying to DD32:

Not to worry. I think theres even a Trac ticket for it.

This'd have to be done anyway.. so that the pluggable functions were just a return apply_filters(__FUNCTION__, false);

I don't see another ticket, but yeah, I realized that this would need to be done either way earlier today.

Infact I think I may just tackle that while I'm at it.

Don't use this patch, it has a bug or two and is a work in progress

Working as far as I can tell, needs testing and feedback

Okay, there's a totally filters/actions based patch. Seems to work perfectly, but needs testing. :)

Patch refresh for [11147]

Remove an accidental part of a collision error message

patch is broken against 11256

Replying to Denis-de-Bernardy:

patch is broken against 11256

Yes, I stopped updating the patch until I hear whether there is interest in this or not. No sense in devoting time to it if it won't get committed.

I know the feeling...

Just for reference, though, this one:

function wp_password_change_notification( &$user ) { 
   do_action( 'pluggable-wp_password_change_notification', $user );
}

should be using do_action_ref_array(), or whatever it's called, due to the reference.

Oh, right, forgot about that function.

If this ticket gets the green light, I'll update my patch to include that.

will close in a month if there still isn't any feedback. no point in letting this rot for another year.

The original idea is good and 8833.2.patch looks good. However I'm not sure how the filter based replacements would behave when there are several plugins using them.

Currently when two or more plugins try to replace the same pluggable function the first one "wins" (and keeps working) and the second fails. If we add something like 8833.2.patch, the second would be able to use the default function and still work in most cases. However if we pass filtered values from one plugin to the other chances are that both would fail for some functions.

IMHO switching from !function_exists() to add_filter()/add_action() would require a lot of testing both as a usable solution and for regressions/back-compat and would break some plugins.

Marked #18405 as duplicate.

I know there's not a lot of traction on this ticket, but I'd like to add a bit of feedback (partly because it was recently mentioned again on hackers).

With more than one plugin trying to override a given pluggable function, there will only be one winner. The problem is that some of the pluggable functions are too wide in scope, and two different plugins may be trying to override the same pluggable function in its entirety just to change on bit of its functionality.

I think many of the pluggable functions should be split into multiple functions, with their individual bits of functionality being filterable. This way, plugins can override (and "win") more tightly focused functions.

One example is wp_mail(), which does far more than just send an email. It parses headers (including the 'from', 'cc' and 'bcc' fields), sets the 'from' name and address, sets content types, deals with charsets, adds custom headers, adds attachments, and finally sends an email.

Changing this from from being pluggable to being filterable doesn't overcome the issue where you may want to run multiple email-related plugins at the same time, such as one which gives you HTML emails and one which sends your emails through an email delivery service.

Another example is the various notification functions such as wp_notify_moderator(), wp_notify_postauthor() and wp_new_user_notification(). These functions have a mixture of logic in them determining whether or not to send a notification, the notification message itself, and additional stuff such as the 'from' headers in the email. What a user cannot do, for example, is install one plugin to change the text in these emails and another plugin which allows you to control when and whether these notifications are sent.

A good first step would be to look at splitting some of these functions up, and deciding which of the subsequent functions should have their output filterable (eg. the text sent in notification emails) and which should have their callback function filterable (eg. the function which actually sends email).

I'd be willing to start looking at this over the next few weeks if it'll get some traction.

Replying to johnbillion:

Changing this from from being pluggable to being filterable doesn't overcome the issue where you may want to run multiple email-related plugins at the same time, such as one which gives you HTML emails and one which sends your emails through an email delivery service.

I guess if there were filters for that (some probably already exist), plugins would be updated to use them instead of copying the functions.