Skip to Content

Frequently Asked Questions

Last Modified: December 8, 2020

Have a question that isn’t answered here?

Use the Discussions tab on the Github repo »

  • How do I add my logo?

    Using the WordPress Customizer is the easiest and fastest way to handle this. Use the “Brand” section to upload a full-color and one-color version of the logo, then in the “Home” section you can choose which version to use in the header.

  • How do I add a Bootstrap button for my tertiary brand color?

    Use the Sass mixin add-color-class(). More info here »

  • How can I switch to Font Awesome Pro?

    You’ll simply need to deregister Nebula’s bundled version of Font Awesome Free and re-register Font Awesome Pro with the same handle. This is done in your child theme functions file. Instructions and code snippet here »

  • How do I use the service worker?

    Service workers have many benefits from reducing load time to being able install and work offline– just like an app. For background about service workers, here is more information »

    Nebula provides a stock service worker file in the /resources/ directory of the child theme. Simply move this file to the root directory of your website and then be sure to enable the Service Worker option in Nebula Options.

  • How do I cache and compress files?

    Nebula provides a stock .htaccess file in the /resources/ directory of the child theme. Simply move this (or copy/paste the parts you want) to the root directory of your website. Be sure to follow the “@todo” instructions at the top.

    Problems here can cause a 500 error on your website, so be very careful!

  • How do I enable the TODO Manager and Developer Information dashboard metaboxes?

    In Nebula Options under the Administrative tab, make sure you add either an IP address or email domain (or both) for developers. Then ensure the corresponding toggle is enabled for the metaboxes themselves. You should then see them appear on the dashboard.

  • How do I find the "handle" to get a Nebula Option?

    For developers, the Nebula Options page itself provides the actual handles for each option. Simply click the “(?)” icon for the desired option to see it.

    If you don’t see it, make sure you’ve updated the Administrative options to include the IP or email domains of developers.

    All Nebula option handles can be viewed here as well »

  • Does Nebula provide stock Regular Expressions (RegEx)?

    Yes. Nebula provides some stock RegEx in JavaScript. These can be found in the nebula object as nebula.regex and can be modified/overwritten in your child theme’s main.js file.

  • What is the Nebula Companion plugin?

    The Nebula Companion plugin provides more nuanced functionality that many standard websites may not need. It also includes substantially more in-depth auditing capabilities. It can be installed from the Recommended Plugins screen and updated just like any other WordPress plugin.

    Any issues with the Nebula Companion plugin can be reported in the main Nebula Github repo itself.

  • How should I setup Google Analytics to work best with Nebula?

    It’s difficult to summarize this, but Nebula provides tons of analytics assistance. Some of them you won’t need to do anything to benefit from, but others will need to be setup in Google Analytics first (like Goals and Custom Definitions).

    This list of recommendation touches on many of them »

  • Does Nebula support Google Tag Manager?

    Yes! You can enter a GTM ID instead of a Google Analytics Tracking ID and Nebula will understand you are using GTM. You are responsible for the GA data connection via GTM, and likewise you will need to “listen” for event tracking yourself. However, Nebula does push its events to the datalayer for you to utilize.

    Nebula also “announces” when its generic listeners are triggered by the user along with all the data it captured. Use the nebula_event event listener for this.

  • Where can I find an example Contact Form 7 code snippet?

    To best utilize Nebula for user experience and analytics, you’ll want to make sure all of the proper classes are applied to your CF7 form.

    Nebula provides examples for Contact Form 7 settings here »

  • Can I detect the user's location without IP lookups?

    The user’s browser contains information about the language and country code (Ex: en-US). This data is available as an attribute on the <html lang="en-US"> and Nebula also provides it as a class on the body tag lang-en-us.

    To get this information in PHP on the server-side, use get_bloginfo('language').

  • How do I deregister/dequeue styles and scripts from other plugins?

    I wrote instructions here to walk through how to use several Nebula features to find and deregister third-party assets.

  • How do I output the "internal search keywords" text in each post?

    This can be output with the following code: <?php echo get_post_meta($id, 'nebula_internal_search_keywords', true); ?>

    Remember that these are not to be used for keyword stuffing for SEO. This text area is strictly meant for aiding internal searches/filters with synonyms, plurals, and alternate spellings (like common typos).