Author Archives: Drew Jaynes

#4: the_weekday_date

The the_weekday_date filter makes it possible to change the displayed day of the week a post was published, when the function of the same name — the_weekday_date() — is used inside the Loop.

It is located in wp-includes/general-template.php and the_weekday_date() only outputs the day if the current post’s weekday is different from the previous one output (why this would be needed, I have no idea).

The filter accepts three arguments:

  1. string $the_weekday_date The day of the week
  2. string $before Text or markup before
  3. string $after Text or markup after

The original value of $the_weekday_date is determined using a chain of functions to snag the localized day of the week:

  • the get_weekday() method of the WP_Locale class
  • mysql2date()

Example:

Let’s say you wanted to convert the day ‘Saturday’ into pirate-speak, something like ‘SatARRRday’ and were using the_weekday_date() to output it in the Loop.

#3: wpmu_signup_user_notification

The wpmu_signup_user_notification filter is used in a boolean — or true/false — capacity to determine whether a confirmation email should be sent for new user signups in Multisite. It defaults to true.

It is evaluated in its namesake function, wpmu_signup_user_notification(), located in wp-includes/ms-functions.php.

The filter accepts four arguments:

  1. string $user The user’s login name
  2. string $user_email The user’s email
  3. string $key The activation key from wp_signup_user()
  4. array $meta By default, an empty array

If $user is not empty, the filter returns a value of true. Core uses the filter in just this capacity to disable sending a signup email when the ‘Skip Confirmation Email’ checkbox is selected on the Users > Add New screen.

Example:

Let’s say we only want to disable the user confirmation email for users who don’t have a Gmail address. We’ll test the user email for signs of Gmail and return false if we find it.

#2: dashboard_primary_title

On Hold
— I couldn’t get this filter to work. Neither could a couple of other people, so until there’s clarification on whether it still even has a purpose, I’m going to wait.

If you’re curious … the filter is only evaluated if the dashboard_primary widget options aren’t set. And it appears that is never the case.

The dashboard_primary_title filter allows you to modify the title of the ‘WordPress Blog’ dashboard widget.

The filter is evaluated in wp_dashboard_setup() as part of the callback passed to wp_add_dashboard_widget() for creating the ‘WordPress Blog’ dashboard widget in in wp-admin/includes/dashboard.php.

Side note: As this filters a translatable string, your single-language filtered value could override a valid translation of the string. So keep that in mind.

Example:

Since we all love WordPress news, let’s say we wanted to change the name of the ‘WordPress Blog’ dashboard widget to something more awesome. The following example modifies the widget title to ‘Awesome WordPress Blog’.