WP247 Body Classes

Add unique classes to the body tag for easy styling based on post attributes (post type, slug, and ID) and various WordPress “is” functions:

• wp_is_mobile()
• is_home()
• is_front_page()
• is_blog()
• is_admin()
• is_admin_bar_showing()
• is_404()
• is_super_admin()
• is_user_logged_in()
• is_search()
• is_archive()
• is_author()
• is_category()
• is_tag()
• is_tax()
• is_date()
• is_year()
• is_month()
• is_day()
• is_time()
• is_single()
• is_sticky()
• $post->post_type
• $post->name
• $post->ID
• wp_get_post_categories() (Page/Post Categories)
• wp_get_post_tags() (Page/Post Tags)
• $user->nicename
• $user->id
• $user->roles
• $user->allcaps
• $archive->slug (e.g. Category slug, Tag slug, etc.)
• $archive->id (e.g. Category id, Tag id, etc.)

Add post specific classes to the body tag in the post editor. Use any class name you want to uniquely style an individual post or a set of posts.

Add classes based on user scrolling through the page. You can check things like:

• is-scroll-top (at the top of the page – synonym for is-not-scroll)
• is-not-scroll-top (not at the top of the page – synonym for is-scroll)
• is-scroll (not at the top of the page – synonym for is-not-scroll-top)
• is-not-scroll (at the top of the page – synonym for is-scroll-top)
• is-scroll-top-px (has not reached the scroll start value for scroll measurement by pixels)
• is-scroll-top-vh (has not reached the scroll start value for scroll measurement by viewport height)
• is-scroll-top-dh (has not reached the scroll start value for scroll measurement by document height)
• is-scroll-10-px (scrolled down 10 pixels)
• is-scroll-8-vh (scrolled down 8% of the viewport height)
• is-scroll-5-dh (scrolled down 5% of the document height)
• is-scroll-mid-px (has reached the scroll start value but not the scroll limit for scroll measurement by pixels)
• is-scroll-mid-vh (has reached the scroll start value but not the scroll limit for scroll measurement by viewport height)
• is-scroll-mid-vh (has reached the scroll start value but not the scroll limit for scroll measurement by document height)
• is-scroll-max-px (has reached the scroll limit for scroll measurement by pixels)
• is-scroll-max-vh (has reached the scroll limit for scroll measurement by percent of viewport height)
• is-scroll-max-dh (has reached the scroll limit for scroll measurement by percent of document height)

Add classes based on the results from mobiledetect.net’s Mobile_Detect script. This script parses the value passed by the browser in the HTTP_USER_AGENT string. Consequently, mobile detection is more of an art than a science and, unfortunately, is not perfect. You can check things like:

• is-mobile
• is-tablet
• is-phone
• Mobile Operating System
• Mobile Browser
• Type of tablet
• Type of phone

This plugin adds classes to the html body tag indicating:

• whether or not the requesting device is a mobile device (.is-mobile or .is-not-mobile)

• the type of post being viewed (.is-? where ? is the post type (page, post, whetever special post types are defined) ).
  E.g. .is-page or .is-post

• the slug of the post being viewed (.is-?-! where ? is the post type and ! is the post slug).
  E.g. a post with slug “hello-world’ would have class .is-post-hello-world

• the ID of the post being viewed (.is-?-# where ? is the post type and # is the post ID).
  E.g. a post with ID “1” would have class .is-page-1

• whether or not the requested page shows archived results (.is-archive or .is-not-archive)

  If the page being displayed is an archive

  • the type of archive being viewed (.is-? where ? represents the type of archive (author, category, date, tag) )
    E.g. .is-author

  • the slug of the archive being viewed (.is-?-! where ? is the archive type and ! is the archive slug)
    E.g. a category with slug “uncategorized’ would have class .is-category-uncategorized

  • the ID of the archive being viewed (.is-?-# where ? is the archive type and # is the archive ID)
    E.g. a category with ID “1” would have class .is-category-1

  How far down the page the viewer has scrolled in pixels or as a percentage of viewport height or as a percentage of document height

  Post specific class(es) that are set in the post editor

  Use these classes in your styling to provide a better browsing experience for your viewers.

  Custom Body Classes

  Create your own Custom Body Classes by adding your PHP code in the “Custom Body Classes” section.

  Here’s an example. Not sure why we would want to do it, but suppose we want to do some custom styling when the page is being displayed to someone that can manage WordPress options. We might enter something like:

  if (current_user_can('manage_options')) $classes[] = 'user-can-manage-options';
  

  Read the full description on the official page →