Contents

1. How do I add/remove widgets and Visual Composer elements to the sidebar?

2. I cannot access the drop down menu links on Android devices?

3. CDN images are not working on my site?

4. I cannot see any related posts?

5. I can't save the Theme Options page?

6. How do I enable comments on pages?

7. My site is running slow, what can I do?

8. How do I add a Favicon to my site?

9. How do I insert advertisements on my site?

10. I cannot see the icons on my site?

11. Why do I not see the featured images on my site?

12. How do I create BuddyPress groups?

13. How do I show the back to top button on mobile/tablet devices?

14. How do I remove category links from showing up?

15. How do users add avatars (images) to their profiles?

1. How do I add/remove widgets and Visual Composer elements to the sidebar?

1) If you don't want to display Visual Composer elements in your sidebar go to Appearance > Sidebars Editor select the desired sidebars and click the green "Override widgets" button so it turns grey. This is essential if you're just adding normal widgets and can't see them in your sidebar/footer areas.

2) If you want to display only Visual Composer elements in your sidebar go to Appearance > Sidebars Editor select the desired sidebars and click the green "Override widgets" button so it turns green if it's not already enabled.

3) If you want to display both Visual Composer elements and ordinary widgets in your sidebar go to Appearance > Sidebars Editor select the desired sidebars and click the green "Override widgets" button so it turns green if it's not already enabled. Set the Override behavior to "Place before existing widgets".

2. I cannot access the drop down menu links on Android devices?

By default Android will redirect to the top level menu item link URL as soon as it is tapped. To display a submenu, users must tap, and without lifting their finger slide off of the menu item.

3. CDN images are not working on my site?

The theme uses the Aqua Resizer script to resize/crop images to the selected size, this script only accepts images hosted on the same server as the site so CDN images will not work.

In order to support CDN images you will need to disable the cropping functionality. This is not an elegant solution as this will mean the full size images are loaded in all cases but at least your images will be working. To do this copy the following function to your child theme's functions.php file:

Replace "http://cdnurl.com/wp-content/uploads" with your CDN uploads directory.

class Aq_Exception extends Exception {}
class Aq_Resize
{
    /**
     * The singleton instance
     */
    static private $instance = null;
    /**
     * Should an Aq_Exception be thrown on error?
     * If false (default), then the error will just be logged.
     */
    public $throwOnError = false;
    /**
     * No initialization allowed
     */
    private function __construct() {}
    /**
     * No cloning allowed
     */
    private function __clone() {}
    /**
     * For your custom default usage you may want to initialize an Aq_Resize object by yourself and then have own defaults
     */
    static public function getInstance() {
        if(self::$instance == null) {
            self::$instance = new self;
        }
        return self::$instance;
    }
    /**
     * Run, forest.
     */
    public function process( $url, $width = null, $height = null, $crop = null, $single = true, $upscale = false ) {
        try {
            // Validate inputs.
            if (!$url)
                throw new Aq_Exception('$url parameter is required');
            if (!$width && !$height)
                throw new Aq_Exception('$width and $height parameter are required'); // MODIFIED
            // Caipt'n, ready to hook.
            if ( true === $upscale ) add_filter( 'image_resize_dimensions', array($this, 'aq_upscale'), 10, 6 );
            // Define upload path & dir.
            $upload_info = wp_upload_dir();
            $upload_dir = $upload_info['basedir'];
            $upload_url = 'http://cdnurl.com/wp-content/uploads';
            
            $http_prefix = "http://";
            $https_prefix = "https://";
            $relative_prefix = "//"; // The protocol-relative URL
            
            /* if the $url scheme differs from $upload_url scheme, make them match 
               if the schemes differe, images don't show up. */
            if(!strncmp($url,$https_prefix,strlen($https_prefix))){ //if url begins with https:// make $upload_url begin with https:// as well
                $upload_url = str_replace($http_prefix,$https_prefix,$upload_url);
            }
            elseif(!strncmp($url,$http_prefix,strlen($http_prefix))){ //if url begins with http:// make $upload_url begin with http:// as well
                $upload_url = str_replace($https_prefix,$http_prefix,$upload_url);      
            }
            elseif(!strncmp($url,$relative_prefix,strlen($relative_prefix))){ //if url begins with // make $upload_url begin with // as well
                $upload_url = str_replace(array( 0 => "$http_prefix", 1 => "$https_prefix"),$relative_prefix,$upload_url);
            }
            
            // Check if $img_url is local.
            if ( false === strpos( $url, $upload_url ) )
                throw new Aq_Exception('Image must be local: ' . $url);
            // Define path of image.
            $rel_path = str_replace( $upload_url, '', $url );
            $img_path = $upload_dir . $rel_path;
            // Check if img path exists, and is an image indeed.
            if ( ! file_exists( $img_path ) or ! getimagesize( $img_path ) )
                throw new Aq_Exception('Image file does not exist (or is not an image): ' . $img_path);
            // Get image info.
            $info = pathinfo( $img_path );
            $ext = $info['extension'];
            list( $orig_w, $orig_h ) = getimagesize( $img_path );
            // Get image size after cropping.
            $dims = image_resize_dimensions( $orig_w, $orig_h, $width, $height, $crop );
            $dst_w = $dims[4];
            $dst_h = $dims[5];
            // Return the original image only if it exactly fits the needed measures.
            if ( ! $dims && ( ( ( null === $height && $orig_w == $width ) xor ( null === $width && $orig_h == $height ) ) xor ( $height == $orig_h && $width == $orig_w ) ) ) {
                $img_url = $url;
                $dst_w = $orig_w;
                $dst_h = $orig_h;
            } else {
                // Use this to check if cropped image already exists, so we can return that instead.
                $suffix = "{$dst_w}x{$dst_h}";
                $dst_rel_path = str_replace( '.' . $ext, '', $rel_path );
                $destfilename = "{$upload_dir}{$dst_rel_path}-{$suffix}.{$ext}";
                if ( ! $dims || ( true == $crop && false == $upscale && ( $dst_w < $width || $dst_h < $height ) ) ) {
                    // Can't resize, so return false saying that the action to do could not be processed as planned.
                    //throw new Aq_Exception('Unable to resize image because image_resize_dimensions() failed');
                    $img_url = $url; // MODIFIED
                }
                // Else check if cache exists.
                elseif ( file_exists( $destfilename ) && getimagesize( $destfilename ) ) {
                    $img_url = "{$upload_url}{$dst_rel_path}.{$ext}";
                }
                // Else, we resize the image and return the new resized image url.
                else {
                    $editor = wp_get_image_editor( $img_path );
                    if ( is_wp_error( $editor ) || is_wp_error( $editor->resize( $width, $height, $crop ) ) ) {
                        throw new Aq_Exception('Unable to get WP_Image_Editor: ' . 
                                               $editor->get_error_message() . ' (is GD or ImageMagick installed?)');
                    }
                    $resized_file = $editor->save();
                    if ( ! is_wp_error( $resized_file ) ) {
                        $resized_rel_path = str_replace( $upload_dir, '', $resized_file['path'] );
                        $img_url = $upload_url . $resized_rel_path;
                    } else {
                        throw new Aq_Exception('Unable to save resized image file: ' . $editor->get_error_message());
                    }
                }
            }
            // Okay, leave the ship.
            if ( true === $upscale ) remove_filter( 'image_resize_dimensions', array( $this, 'aq_upscale' ) );
            // Return the output.
            if ( $single ) {
                // str return.
                $image = $url;
            } else {
                // array return.
                $image = array (
                    0 => $url,
                    1 => $dst_w,
                    2 => $dst_h
                );
            }
            return $image;
        }
        catch (Aq_Exception $ex) {
            error_log('Aq_Resize.process() error: ' . $ex->getMessage());
            if ($this->throwOnError) {
                // Bubble up exception.
                throw $ex;
            }
            else {
                // Return false, so that this patch is backwards-compatible.
                return false;
            }
        }
    }
    /**
     * Callback to overwrite WP computing of thumbnail measures
     */
    function aq_upscale( $default, $orig_w, $orig_h, $dest_w, $dest_h, $crop ) {
        if ( ! $crop ) return null; // Let the wordpress default function handle this.
        // Here is the point we allow to use larger image size than the original one.
        $aspect_ratio = $orig_w / $orig_h;
        $new_w = $dest_w;
        $new_h = $dest_h;
        if ( ! $new_w ) {
            $new_w = intval( $new_h * $aspect_ratio );
        }
        if ( ! $new_h ) {
            $new_h = intval( $new_w / $aspect_ratio );
        }
        $size_ratio = max( $new_w / $orig_w, $new_h / $orig_h );
        $crop_w = round( $new_w / $size_ratio );
        $crop_h = round( $new_h / $size_ratio );
        $s_x = floor( ( $orig_w - $crop_w ) / 2 );
        $s_y = floor( ( $orig_h - $crop_h ) / 2 );
        return array( 0, 0, (int) $s_x, (int) $s_y, (int) $new_w, (int) $new_h, (int) $crop_w, (int) $crop_h );
    }
}

4. I cannot see any related posts?

Related posts are only displayed if posts have one or more of the same post tags as the post you are viewing. To add post tags to posts, on the right-hand side of the post add your tags from the "Tags" panel.

5. I can't save the Theme Options page?

This error occurs because your server limits the amount of data that can be saved at one time. There are two ways to increase this limit:

1) Edit your php.ini file and increase the max_input_vars function to around 3000 e.g.

max_input_vars = 3000;

2) Alternatively edit your .htaccess file (in the root of your WordPress installation) and add:

php_value max_input_vars 3000

If you're not able to do either of these please ask your webhost to do this for you.

6. How do I enable comments on pages?

Go to Settings -> Discussion and make sure Allow people to post comments on new article is checked.

Now on any page click the Screen Options button in the top right corner of the page and check the Discussion option.

Since WordPress 4.3 comments are not enabled on pages by default - to enable them use the following plugin: https://wordpress.org/plugins/no-page-comment/

7. My site is running slow, what can I do?

Before blaming the theme there are a number of things that may be causing your site to slow down. 

First ask yourself, does this issue occur when you are using any other theme? If it does, then it's probably a server or plugin issue. If it's a plugin issue, disable all plugins and reactivate them one by one to find which one(s) are causing the slow down. If it's a server problem then you should contact your web host.


If this issue only occurs when using this theme there are a number of things you can do to improve the pagespeed, as follows:

Install a cache

This is an absolute must. If you're not already using a caching plugin and you're complaining about page speed install a caching plugin immediately! I recommend WP Super Cache or W3 Total Cache.

Optimize images

Optimizing your images reduces their file size without losing picture quality. You can either use a program that does this before uploading your images to your server (such as ImageOptim for the Mac) or you can use a WordPress plugin that does this after uploading your images.

Minify JavaScript and CSS files

Minifying your JavaScript and CSS files basically makes these files as small as possible so they load quicker. There are plenty of plugins out there that minify these files, I recommend Better WordPress Minify.

Remove Query Strings from Static Resources

Use the following Remove Query Strings From Static Resources plugin to remove query strings from static resources like CSS & JS files, to improve your speed scores in services like PageSpeed, YSlow, Pingdom and GTmetrix. Resources with a “?” or “&” in the URL are not cached by some proxy caching servers, and moving the query string and encode the parameters into the URL will increase your WordPress site performance.

Use a VPS or dedicated server

If you are hosted on a shared server you should really consider moving to a VPS or dedicated server. A shared server distributes the server resources across many sites leading to a noticeable slow down when sites on the server have a lot of visitors. If your own site is getting a decent number of visitors you should definitely not be using a shared server. With VPS and dedicated servers you have your own server resources that are not used by any other sites.

Use a CDN to load media, CSS and JavaScript files

A Content Delivery Network (CDN) works by providing alternative server nodes for users to download your files. These nodes are spread throughout the world, therefore being geographically closer to your users, ensuring a faster response and download time of content due to reduced latency. Some of the most popular CDNs are Amazon S3, Microsoft Windows Azure and MaxCDN.

For Gauge users also check out the following video from a fellow buyer:



If you're hosted on a VPS/dedicated server, installed a cache, optimized your images and minified your files and still experience page speed issues then I will need some more information from you in order to determine the cause of this issue.

1) Run your site through http://tools.pingdom.com/ and provide me with the link to the results page.

2) Provide me with WordPress admin access (URL, username and password).

8. How do I add a Favicon to my site?

This is controlled by WordPress, not the theme. Go to Appearance > Customize > Site Identity > Site Icon.

9. How do I insert advertisements on my site?

To insert advertisements in the header and footer go to the Theme Options page of your theme and locate the header and footer content options (not available on all themes).

To insert advertisements in your sidebar go to Appearance > Widgets and add your ad or image code into the Text Widget.

To insert advertisements within the page content go to Appearance > Sidebars Editor and insert your ad or image code into the Raw JS Visual Composer element (not available on all themes).

You can also use a variety of ad plugins to insert advertisements within your posts/page. The plugin "Wp-Insert" has been tested with this theme.


10. I cannot see the icons on my site?

This is probably because of a permission issues with the font used to display the icons. Using an FTP client set lib/fonts/ and lib/fonts/fontawesome/ permissions to 755 and the font file permissions to 644.

11. Why do I not see the featured images on my site?

1) Make sure you have selected a featured image for each post/page/slide.

2) Make sure you have not set the image width to 0 or left it empty on the Theme Options pages, Also make sure you've not set it to 0 (it can be left empty) on individual post/pages and shortcodes.

3) Make sure you have an image editor installed on your server such as GD Library or ImageMagick. If you are not sure please ask your web host about this.

4) CDN hosted images are not supported - the images need to be uploaded to the server the site is on.

12. How do I create BuddyPress groups?

I'm not sure why I get this question so often as creating groups has nothing to do with the theme, it's part of the BuddyPress plugin. However since I'm always asked please check the following:

1) Go to Settings > BuddyPress and under the Components tab make sure User Groups is enabled.

2) Go to Settings > BuddyPress and under the Pages tab make sure a page is selected from the User Groups drop down menu.

3) To add a link to this page go to Appearance > Menus and add this page to one of your menus.

4) If you can't create user groups from the frontend, go to Settings > BuddyPress and under the Settings tab enable Group Creation if you want to allow all users to create groups. If you still can't create groups deactivate all plugins (except BuddyPress) to see if this resolves the issue. If it does, reactivate the plugins one by one to fix the problem plugin.

If no plugin is causing the issue activate the Twenty Seventeen theme, if this doesn't resolve the issue, the theme is not causing this problem and you will need to contact BuddyPress support who will be able help you.


13. How do I show the back to top button on mobile/tablet devices?

Go to Theme Options > Styling and in the CSS Code box add :

@media only screen and (max-width: 1023px) {
    .gp-theme #gp-to-top {
    display: block !important;
    opacity: 0.7 !important;
    }
}

14. How do I remove category links from showing up?

Cuckoo, Socialize and Habitat Themes:

Go to Theme Options -> Posts -> Post Categories and add the categories you want to remove to the Exclude Categories box.

Huber Theme:

Go to Theme Options -> General and add the categories you want to remove to the Exclude Post Categories box.

15. How do users add avatars (images) to their profiles?

WordPress uses Gravatar to add avatars (user images). Register a free account at http://gravatar.com, associate it with the email you're using on your WordPress site and upload your avatar image. Now go back to your site and within a short amount of time your avatar will show up in your comments, profile page etc. If you want people to upload an avatar from your own site instead, use a plugin such as "Add Local Avatar".