Load CSS on specific pages

You can optimise how Microthemer loads CSS by assigning folders to specific pages, or types of page. Microthemer does this automatically if the Auto folder option in the footer is enabled. But you may want to customise the default condition, which tends to assign a folder to just one page.

Examples

CSS loading is controlled by PHP-like logical conditions, which Microthemer can help you generate. The following table provides examples of supported conditions. If a condition is evaluated as true on a given page, it means the folder will load its CSS.

Function Reference

Microthemer does NOT use the PHP eval() function. Instead, it reads your conditions as plain text and then runs the relevant function(s). Only a handful of PHP functions are allowed – some WordPress API functions, custom Microthemer functions, and some native PHP, namely $_GET and isset().

Supported WordPress Functions

get_post_type() has_action() has_block() has_category() has_filter() has_meta() has_post_format() has_tag() is_admin() is_archive() is_author() is_category() is_date() is_front_page() is_home() is_page() is_post_type_archive() is_search() is_single() is_singular() is_super_admin() is_tag() is_login() is_user_logged_in()

Custom Microthemer Functions

\Microthemer\is_active() \Microthemer\is_admin_page() \Microthemer\is_public() \Microthemer\is_public_or_admin() \Microthemer\match_url_path() \Microthemer\query_admin_screen() \Microthemer\user_has_role()

\Microthemer\is_active()

Check if a theme or plugin is active. Enter the type of item to check as the first parameter. Enter the directory name of the theme inside /wp-content/themes or the plugin inside /wp-content/plugins.

Usage Examples

• \Microthemer\is_active(‘theme’, ‘twentytwentythree’)
• \Microthemer\is_active(‘plugin’, ‘microthemer’)
• \Microthemer\is_active(‘plugin’, ‘wp-rocket’)

Source code

function is_active($item = null, $slug = null){
   switch ($item) {
      case 'plugin':
	$active_plugins = get_option('active_plugins', array());
	foreach($active_plugins as $path){
	   if (strpos($path, $slug) !== false){
	      return true;
	   }
	}
        return is_plugin_active_for_network($slug);
      case 'theme':
	   $theme = wp_get_theme();
	   return $theme->get_stylesheet() === $slug;
      default:
	   return false;
   }
}

\Microthemer\is_admin_page()

Check if the current page is any admin page, or a specific admin page. Optionally pass in a single parameter that can either be a PHP file name or a post id. If no parameter is passed in, the function will return true if it is any admin area page.

Usage Examples

• \Microthemer\is_admin_page()
• \Microthemer\is_admin_page(4)
• \Microthemer\is_admin_page(‘edit.php’)

Source code

function is_admin_page($pageNameOrId = false){

   return is_admin() 
      && !$pageNameOrId
      || (
            isset($GLOBALS['pagenow']) 
            && $GLOBALS['pagenow'] === $pageNameOrId
          )
      || (
            is_numeric($pageNameOrId) 
            && isset($_GET['post']) 
            && intval($_GET['post']) === intval($pageNameOrId)
          );
}

\Microthemer\is_public()

Check if the current page is a public facing page (i.e. the frontend, not the admin area). This function does not accept any parameters.

Usage Example

• \Microthemer\is_public()

Source code

function is_public(){
  
   return !is_admin();
}

\Microthemer\is_public_or_admin()

Checks if the current page is on the admin side or the frontend. If no parameter is passed in, it will always return true. If a Post or Page id is passed in, it will return true on the admin and frontend for a specific post or page only. This function is useful when you want styles to appear in the Gutenberg editor as well as the frontend. Support for that must be enabled via the Preferences however. And watch the video for advice about targeting elements with single classes.

Usage Examples

• \Microthemer\is_public_or_admin()
• \Microthemer\is_public_or_admin(5)

Source code

function is_public_or_admin($postOrPageId = null){
   
   return !$postOrPageId
      || ( 
            !is_admin() && (is_page($postOrPageId) || is_single($postOrPageId)) 
         )
      || is_admin_page($postOrPageId);
}

\Microthemer\match_url_path()

Check if the URL path for the current page contains a text substring, or matches regex pattern if the second argument is set to true.

Usage Examples

• \Microthemer\match_url_path(‘about’)
• \Microthemer\match_url_path(‘^\/support’, true)
• \Microthemer\match_url_path(‘^\/contact\/$’, true)
• \Microthemer\match_url_path(‘^\/forum\/users\/.+?\/’, true)

Source code

function match_url_path($value = null, $regex = false){
   $urlPath = $_SERVER['REQUEST_URI'];
   return $regex
      ? preg_match('/'.$value.'/', $urlPath)
      : strpos($urlPath, $value) !== false;
}

\Microthemer\query_admin_screen()

Check the value of a WP Screen object property by passing in a property key and value to compare. This function is useful for applying styles to all sorts of admin pages.

Usage Examples

• \Microthemer\query_admin_screen()
• \Microthemer\query_admin_screen(‘action’, ‘add’)
• \Microthemer\query_admin_screen(‘base’, ‘edit’)
• \Microthemer\query_admin_screen(‘is_block_editor’, true)
• \Microthemer\query_admin_screen(‘post_type’, ‘post’)
• \Microthemer\query_admin_screen(‘taxonomy’, ‘category’)

Source code

function query_admin_screen($key = null, $value = null){

   if (!function_exists('get_current_screen')){
      return false;
   }

   $current_screen = get_current_screen();

   return (
             $key === null || isset($current_screen->$key)
          )
       && (
             $value === null || $current_screen->$key === $value
          );
}

\Microthemer\user_has_role()

Check if the current user is logged in and, if a role parameter is passed in, that they are a certain type of user.

Usage Examples

• \Microthemer\user_has_role()
• \Microthemer\user_has_role(‘subscriber’)
• \Microthemer\user_has_role(‘contributor’)
• \Microthemer\user_has_role(‘author’)
• \Microthemer\user_has_role(‘editor’)
• \Microthemer\user_has_role(‘administrator’)

Source code

function user_has_role($role = null){
   
   return is_user_logged_in() 
          && $role === null || wp_get_current_user()->roles[0] === $role;
}