Ad Hoc Portfolio - Agency and Photography Portfolio WordPress Theme

Contents

1. Missing style sheet error when installing the theme

2. Gutenberg

3. I have purchased your theme. Now what?

4. How to translate theme?

5. How to set up your Twitter widget?

6. Is there some way I can see all the icons of the theme?

7. How to update installed theme? Will it change data?

8. How to change the Excerpt text?

9. SVG Image format

10. My Google Maps element does not work. What should I do?

11. Installing Demo Content

12. "404 Page not found" error on inner pages

13. How to change the header and edit other Single pages of Portfolio items settings?

14. Embed code I have placed using text element is being cut off. It does not have the proper height. How can I resolve this?

15. How to set up your Instagram widget?

16. Issues with Grid layout

17. I want to use a child theme. How can I do that?

18. How to disable loading animation?

19. Where is my Purchase Code?

1. Missing style sheet error when installing the theme

A common issue that can occur with users new to installing WordPress themes is a "Broken theme and/or stylesheets missing” error message being displayed when trying to upload or activate the theme. This error message does not mean that the theme you have purchased is broken, it simply means it has been uploaded incorrectly.

You have 2 options for downloading your theme:


Please use Installable WordPress file only archive in the process of Theme installation:

  1. Log in to your WordPress admin area.
  2. Browse to Appearance > Themes.
  3. Click on ‘Add New’.
  4. Click ‘Upload Theme’.
  5. Browse and select the theme zip file to upload, then click 'Install Now' button.


Check our video tutorial how to install theme and import demo content.

Don't forget to subscribe to our YouTube channel!


For more info and detailed instructions please refer to our Online Theme Documentation.

2. Gutenberg

Gutenberg editor will be included in WordPress version 5.0 (available from late November 2018).

Currently our themes use their own Page Builder which should run without problems in parallel with Gutenberg. The problem with existing Gutenberg implementation is that it does not feature all needed structural CSS grid elements at this moment (for example inner row within a column).  This means that multi column layouts cannot be supported and that is essential for our themes. Once they introduce functional grid in Gutenberg, we will include Gutenberg support for our themes.

Note that the classic editor will be available as a plugin if needed.

3. I have purchased your theme. Now what?

The best starting point is to go through the provided documentation. 

It will guide your through the common tasks of theme installation and import of demo content.  

You have 2 options for downloading your theme:


Documentation pdf is in the All files and documentation package. Please download it and the document should be in the root of the downloaded archive.



For more info and detailed instructions please refer to our Online Theme Documentation.

4. How to translate theme?

In order to translate the theme, please follow the next steps:

Theme's .pot file is located in /wp-content/themes/your-theme-name/languages folder.

Please use PoEdit - https://poedit.net/ to translate the .pot file and create respective .po and .mo files.

Please name .po and .mo files e.g. nl_NL.po and nl_NL.mo (nl_NL is the language code for dutch). For other languages' codes, please refer to the following link: Internationalization.

You should upload .po and .mo files created using PoEdit back to languages folder. 

Also make sure to translate the theme's plugin, located in \wp-content\plugins\your-theme-name\languages folder. 

The steps are the same as for the theme, except the files should be named bt_plugin-nl_NL.po and bt_plugin-nl_NL.mo (with appropriate language code).

You can set the site language of your WordPress installation on Settings > General. WordPress will automatically use the right language files if they exist. 

5. How to set up your Twitter widget?

In order to set up your Twitter widget you need following data:

Please follow this procedure to create required data.
1. Go to Twitter Apps, sign in and create New App.

                                

2. Complete the form, here’s a break down of what each field is:


Please check 'I agree'. You are now presented with a Consumer key – copy and paste this somewhere as we need that for the next step.

   


3. Click on 'manage keys and access token'. Then go to ’Create my access token’  and you will get Consumer Secret, Access Token and Access Token Secret.


   



6. Copy Consumer Key, Consumer Secret, Access Token and Access Token Secret and enter them to respective fields of Twitter widget. 



For more info and detailed instructions please refer to our Online Theme Documentation.

6. Is there some way I can see all the icons of the theme?

We use two different sets of icons in the theme: Font Awesome and Stroke 7

Please refer to these links for preview of each icon set.

7. How to update installed theme? Will it change data?

First of all, please make sure to download newest theme version from ThemeForest Download section.

Then, just replace the old theme files with new ones on your server via FTP (provided you haven’t made any changes in the source code. If you did, please reapply them to the new version of the theme or they will be lost). 

Keep your eyes on potential required plugin update messages at wp-admin dashboard once you replace the files. You should update all required plugins if the updated theme suggests so. 

All settings in Customize panel and your content will be preserved.

Note: Once new theme version is online, user who purchased the theme, should get email note from the Envato (ThemeForest).





For more info and detailed instructions please refer to our Online Theme Documentation.

8. How to change the Excerpt text?

All Blog Posts, and even Pages can have Excerpt text.

In order to change the ’Excerpt text’ please take a look at the bottom of edit post page. Since this field is not visible by default, just click Screen options button at top right corner of the form and check Excerpt checkbox. 

                        


This will make excerpt field visible. You will be able to edit Excerpt text.




For more info and detailed instructions please refer to our Online Theme Documentation.



9. SVG Image format

Our themes currently do not support SVG image format. We also don't recommend using any of the plugins for SVG, such as SVG SupportSafe SVG, and others. 

These plugins have not been tested with the themes, are not fully supported, and can cause themes' functionalities, such as Customize panel, to break.

10. My Google Maps element does not work. What should I do?

Google has changed their Google map policies and now Google map APIs require an API key for new domains as of 22nd of June. Please refer to the following announcement: Google Geo Developers.

In order to resolve the issue with Google Map, please follow the next steps:

  1. First of all, you will need to create an API key as per instructions here: Get api key.
  2. After creating, please locate the ad_hoc_portfolio.php file in Plugin Editor and replace the following:
wp_enqueue_script( 
            'gmaps_api',
            'https://maps.googleapis.com/maps/api/js?v=&sensor=false'
        );

with:

wp_enqueue_script( 
            'gmaps_api',
            'https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY'
        );

Please replace the YOUR_API_KEY with newly created API key.

11. Installing Demo Content

The best way to start is to install demo content. If you want to install demo content please do the following:

First, delete all sample content (posts and pages) which is automatically created when WordPress is installed. If you have already added a new content, please make sure to do the backup in order to save the content. After the backup, delete all content and you can start with the next steps:  

1. Start with fresh WordPress installation and delete all sample content (like posts and pages) which is automatically created when WordPress is installed.

2. Go to ‘Tools > Import > WordPress’ and install WordPress Importer plugin if it is not already installed.

3. When it is installed, choose xml file from demo_data folder and click ‘Upload file and import’. On the following screen make sure that ‘Download and import file attachments’ is checked. Click ‘Submit’ button and wait until import is finished.

If import appears broken, please delete any imported menus from Appearance > Menus and repeat the import. Do the same again if necessary (e.g. 5-10 times) until import is completed.

Additionally, because import process depends on server setup, you may ask your hosting provider for help.

12. "404 Page not found" error on inner pages

If after installing demo content inner pages are returning "404 Page not found" error, please try to recreate permalink structure by going to Settings > Permalinks, changing it to Post name, for example, saving the settings, then changing it back to the one you originally had, and saving it again.

13. How to change the header and edit other Single pages of Portfolio items settings?

All single portfolio items inherit the settings from their template page. In order to edit excerpt text and header background image, please locate this page on All Pages list, and proceed to follow instructions from our article.


In order for this page to work as a template page for single portfolio items, make sure to add its slug to Settings Page Slug field in Appearance >Customize >Portfolio panel.

                                                        




For more info and detailed instructions please refer to our Online Theme Documentation.

14. Embed code I have placed using text element is being cut off. It does not have the proper height. How can I resolve this?

It may happen that iframe created by your embed code gets cut off.

Please do the following to resolve this:
1. Define Custom Id for the section containing embed code (for example: section_1)


2. Add the following statements to Custom CSS field of Appearance > Customize > General panel 

#section_1 iframe {
    height: 150px !important;
}

Adjust the height according to your needs.

15. How to set up your Instagram widget?

In order to set up your Instagram widget you need following data:

Please follow this procedure to create your Client ID, and Access token:


Step 01: Getting Client ID 

1. Go to the link: Authentication and login with your Instagram account
2. Click on Manage Clients in the upper right corner
3. Click on Register a New Client.


               


4. Complete the form, here’s a break down of what each field is:


             


You are now presented with a Client ID and the Redirect URL – copy and paste these somewhere (or leave the browser window open) as we need them for the next step.

5. Click on Edit Client button, click on Security Tab and uncheck Disable implicit OAuth. Click on Update button.




Step 02: Getting Access token

Use the url below and replace the bits in UPPERCASE with the information you noted earlier on (Client ID and Redirect URL): https://instagram.com/oauth/authorize/?client_id=YOURCLIENTIDHERE&redirect_uri=HTTP://YOURREDIRECTURLHERE.COM&response_type=token&scope=public_content

Paste the updated URL in to your favorite browser and you will be taken to a page on Instagram that says something like, “Hello [Your Name], [Application Name] is requesting to do the following” followed by a list of permissions – click Authorize to enable and retrieve your token.

You should now have been redirect to the URL you set as your Redirect URL (probably your blog).  At the end of the URL Instagram has directed you to is your access token as a very long series of letters and numbers.  It will almost certainly not all be visible so you’ll need to work a little to get it.  We recommend:

Clicking in the address bar of your browser
Hit CTRL + A on the keyboard to ‘Select All’
Hit CTRL + C on the keyboard to ‘Copy‘
Open a text editor such as Notepad and paste the URL there, you should now be presented with something like this: http://www.bold-themes.com/#access_token=856946666.7338417.ffefasgtasg805784be6ab4f24965e79

Everything after the equals sign (=) is your access token so in our case this would be: 856946666.7338417.ffefasgtasg805784be6ab4f24965e79.


For more info and detailed instructions please refer to our Online Theme Documentation.

16. Issues with Grid layout

If you have activated the theme with the existing content, you will have problems with grid layout.

Once it's activated, our theme generates necessary thumbnails for every newly uploaded image. Since these were uploaded prior to activation of the theme, thumbnails do not exist yet.

In order to correct this, please install the following plugin: Regenerate Thumbnails and run it. Once you do that, all necessary thumbnails will be regenerated and the issue should be resolved. All newly uploaded photos will be ok.


17. I want to use a child theme. How can I do that?

If you want to use Ad Hoc Child Theme, please follow these steps:

1. First of all, make sure that parent theme folder is named: ad_hoc_portfolio. Otherwise rename the folder.

2. You should be able to find the folder ad_hoc_portfolio_child in the package you have downloaded from ThemeForest.

3. Please copy this folder to /wp-content/themes folder on your server.

4. Go to Appearance > Themes in your wp-admin console and activate child theme. Please have in mind that all required plugins need to be activated.

18. How to disable loading animation?

You can disable the loading animation by adding the following piece of code to Custom CSS field in Appearance > Customize > General panel:

#boldPreloader {
    display:none;
}

19. Where is my Purchase Code?

If you are having some troubles finding your Purchase Code, please have a look at the following article: Envato Market Help - Where Is My Purchase Code?