IronBand

Contents

1. When installing the theme it says "Are you sure you want to do this ?"

2. Recommended image size (resolution)

3. How to Add Custom Font and Typography

4. How to change the Slug or page URL of my page?

5. How I change hard-coded texts?

6. How to activate the child theme ?

7. How to get my Twitter API Keys ?

8. Facebook display an unwanted preview of my image and text.

9. How to add a link in the menu that scrolls to a page section (Anchor)

10. How to translate the theme in your own language ?

11. How to duplicate Events, Playlists, Artists, Posts and Custom-Posts

12. How do I update my theme ?

13. How to embed a SoundCloud Player into my pages ?

1. When installing the theme it says "Are you sure you want to do this ?"

There are 2 different causes for this issue.

If you are installing your theme from the WordPress theme dashboard, but get a message that says “Are you sure you want to do this?”, most likely your web server is configured with PHP settings that are too low to allow the theme ZIP file to upload. Specifically, PHP is configured to a maximum file upload size limit at 8 megabytes or less. The theme ZIP is currently about 34 MB. Thus, the web server is rejecting the upload. WordPress is giving you a rather ambiguous message in response.

This is not a theme fault or bug.

SOLUTION 1)

You can either increase your PHP limits. Since every server is configured differently, there are 3 ways to do this. You can try to do it yourself but if you don't have the skill, just ask your hosting provider and they usually will do it for you for free.

To raise the PHP limits, try one of the 3 solutions below:

a) Add this in the .htaccess file of your server php_value memory_limit 128M php_value post_max_size 128M php_value upload_max_filesize 128M php_value max_execution_time 1800

b) Add this to wp-config.php

define(‘WP_MEMORY_LIMIT’, ’64M’); c) Create a text file and name it php.ini then upload php.ini file in your root folder by FTP. In the php.ini file, add: upload_max_filesize = 64M post_max_size = 64M

--- 

If it still doesn't work, you can ask your web host to raise the upload and memory limit (Just tell them you are trying to upload a WordPress theme file that is around 35mb) OR jump to SOLUTION 2 below:

SOLUTION 2)

You can upload your theme via an FTP client. Please read this article for more info: 

 http://codex.wordpress.org/Using_Themes#Adding_New_Themes_Manually_.28FTP.29

----- 

Recommended PHP configuration limits are as follows:

max_execution_time 600

memory_limit 256M

post_max_size 64M

upload_max_filesize 64M

You can verify your PHP configuration limits by installing a simple plugin called WordPress phpinfo().


ADDITIONAL INFO:

Sometimes, you might be trying to upload the whole theme package zip file (which contain the PSD, Licence, Theme, etc..), instead of only the theme zip file.

If that's the case, make sure you unzip the theme package zip file on your computer, then check if there is a /Theme/ folder. If so, make sure you are uploading the theme zip file that is located in that theme folder.

2. Recommended image size (resolution)

Here our image recommendation for a best result with our theme. 

For general backgrounds


 For the Blog "Featured images": 


For the Event "Featured images": 


For the Album "Featured images": 


For the Gallery images: 

3. How to Add Custom Font and Typography

1) Paste this code into Custom CSS field. This will tell your theme to load a custom font.

@font-face {
    font-family: 'MyWebFont';
    src: url('http://yoursite.com/fonts/webfont.eot'); / IE9 Compat Modes /
    src: url('http://yoursite.com/fonts/webfont.eot?#iefix') format('embedded-opentype'), / IE6-IE8 /
    url('http://yoursite.com/fonts/webfont.woff2') format('woff2'), / Super Modern Browsers /
    url('http://yoursite.com/fonts/webfont.woff') format('woff'), / Pretty Modern Browsers /
    url('http://yoursite.com/fonts/webfont.ttf') format('truetype'), / Safari, Android, iOS /
    url('http://yoursite.com/fonts/webfont.svg#svgFontName') format('svg'); / Legacy iOS / }

Just put absolute paths to your font files. Note that you need to have different file formats since some browser will use only certain file type as explained here https://css-tricks.com/snippets/css/using-font-face/

2) Then use this CSS code by placing it inside Custom CSS field as well for the specific CSS class you want to use the font:

body, h1{font-family: 'MyWebFont', sans-serif;}

The example above will use the custom font called "MyWebFont" for the Body and H1 class.

Another option is use the plugin called:  "Use Any Font". Some customers have recommended it but we didn't test it.

4. How to change the Slug or page URL of my page?

You have created a page and the slug name doesn't match the page name. It has an undesirable "-2" which is added. You are trying to remove it but you can't.

Most often, the reason is that your permalink is already in use.

Check the permalinks of your pages and beware that the permalink might be already used by a page in the trash. Make sure to check in your trash section of your pages/posts. 

Another case that it won't work is because you are trying to use a slug name that is dedicated as a parent of a post type. Permalinks: "/discography", "/event", "/videos" are dedicated.  You cannot use them.

So if you have created a page called "videos", the default permalink will be "/videos-2". You can't use "videos". You can use another slug name as "video" or "-videos-" Or you can also make your page a child page, so the permalink will change. (ex: "/medias/videos")

5. How I change hard-coded texts?

Some texts in our theme are hard-coded, like back and next buttons or labels days, hours, minutes from the countdown. You can't find an option to edit them on the wp-admin dashboard.

So how we can customize them without modifying our theme? The solution is simple. We need to translate string from our theme.

Example. you want to translate  "No upcoming events scheduled yet. Stay tuned!" to "We are on vacation for two years", we need to make an English translation.  How to do it?

*** In this tutorial, I use often "[your theme name]". Its intended to be replaced by your own theme name eg(fwrd, lush, croma, soundrise, etc..)

1. Download and Install PoEdit software: https://poedit.net/

2. Open Poedit and open file /wp-content/themes/[your theme name]/languages/[your theme name].pot.

3. Click on edit and find, and search for the string you want to modify. 

4. If you don't find the string, please open a /wp-content/plugins/[your theme name]-music/languages/[your theme-name]-music.pot and repeat step 3. 

5. When you have found in which file is located the string please click on create a new translation.

6. Select the same language selected in your WordPress. 

If you are not sure which language is set to your wordpress, please go to wp-admin>setting>general.

7. Find your string again and fill the translation field with your new string.

8. Click on save and save your files in /wp-content/languages/themes.

* If the modification is from our plugin, you need to save file in /wp-content/languages/plugins and the file name should start with "[your theme name]-music-en_US". Exemple: "croma-music-en_US.po". 

When we save the po file, a .mo file will be automatically generate. The mo file is the file read by wordpress.  

6. How to activate the child theme ?


The child theme comes with the full package that you can download from ThemeForest.

Make sure that you previously uploaded the main theme before installing the child theme.

Step-by-step guide:

1. Go to your download tab in ThemeForest (http://themeforest.net/downloads) and download “All files & Documentations”. See screenshot: http://d.pr/i/12oHu

2. Unzip the file on your computer

3. Go to the /Theme/ folder and you will see the child theme zip file (eg: lush-child.zip) which is the child theme that you will upload to your Wordpress

4. Go to WP-Admin > Appearance > Themes and click on 'add new'.

5. Select the child theme's zip file and upload it.

6. Activate it.

7. How to get my Twitter API Keys ?

In order to use a Twitter feed on your website, you need to tell Twitter that you are the owner of account used. To do this, you need to create a Twitter Application.



Here's the steps



Creating a Twitter Application

The Twitter Widget will never ask for your password, as it gets all your required data from the Open Authentication keys and secrets you will get by creating your application at Twitter. It also means that if you change your twitter password, you won’t need to update any of the details of your Widget.

  1. Go to https://apps.twitter.com/ and sign in.
  2. Click "Create New App."
  3. Enter a unique Name (anything you want), a Description (again this is just for you), and your site's URL. You can leave the Callback URL empty as it is not used for this implementation. Yay, success - OK! 
  4. Click the "Keys and Access Tokens" tab.
  5. Click the button "Create my access tokens". See screenshot: http://d.pr/i/17Uhs
  6. Now you should see all the keys that are required. See screenshot: http://d.pr/i/1go15
  7. Good. Now go to your WordPress Dashboard and go to the theme options. Click the Social Media tab. 
  8. You can just copy the required information into the exact corresponding inputs fields of the theme options. See screenshot: http://d.pr/i/1fH4x

8. Facebook display an unwanted preview of my image and text.

The easy way to manage the site preview that shows up on Facebook is the free plugin Yoast SEO. With this plugin, you will be able to display what you want onto the preview and it will help you to improve your site’s SEO. 

  1.  Download the Yoast SEO plugin.
  2. Install and activate it on your WordPress site.
  3. Edit your homepage backend and look for the Yoast SEO setting.
  4. Click on the social icon


  1. And fill the title and description fields. You can also select a new preview image


See the full Yoast SEO Documentation here

9. How to add a link in the menu that scrolls to a page section (Anchor)

First you need to create an anchor that will be the "target".

With Visual Composer, it's very easy to create an anchor.

1. Click the "pen" icon of the row element you want the anchor:

2. Fill the 'ID Name for Navigation' field with the name of the anchor you want. (Eg: about, music or contact). Do not use space or special characters.

3. Add a new menu item in your menu: Go to WP-Admin > Appearance > Menus.

4. Create a new 'Custom Links'. In the 'url' field, add "/#" and your Anchor ID you previously set. So if your anchor is about, the url will be /#about

* If you need to point to an anchor which is on another page than your homepage, then you need to add the slug name in the url. Eg: /bio/#about

10. How to translate the theme in your own language ?

Translate in your own language

  1. Download and Install PoEdit software: https://poedit.net/
  2. Unzip the theme file you have downloaded from ThemeForest.
  3. In the folder /Theme/ you will see the theme .zip file. Unzip it as well.
  4. Open Poedit and click on File -> New from POT/Po file in the main menu and select the POT file in your theme’s languages folder. The .POT file should be located in your /Theme/theme_name_folder/languages/
  5. A properties box will open up. Select the language name you want to translate to.
  6. Now you can start translating the theme via the String Translation mechanism. This provides direct like-for-like translations. Go through each line one-by-one, adding the translation to your native language as you go. If you think there’s some text that won’t require translation or you’re not sure what to translate it to you can just leave them as they are in the original language; you can always come back and translate them later if need be. You don't have to translate everything. Remember that strings that you have not translated will appear in english in your site. The string you have translated will show the corresponding translations.
  7. Go to File -> Save. You’ll be asked to what filename you want to save your .po file. Each language and country has a specific code you will need to use when saving translation files; for instance, if you’re going to translate into Spanish you’ll name your file “themename-es_ES.po”, whereas if you’re translating into German you’ll name the file “themename-de_DE.po”, french from France will be "themename-fr_FR.po", french from Canada will be "themename-fr_CA.po". To break it down; the first lower-case letters defines the language, whereas the second upper-case letter defines the country. In many cases the language and country will be the same, hence “de_DE” for Germany, but what about languages like English or Portuguese, that are spoken in several countries natively? In these cases there will be a difference in the first and second letter pairs; for the UK, the code would be en_GB, whereas for the USA it will be en_US. If you’re not familiar with the codes for your native language and country you can head over to the GNU website, where they have all the codes for Language and Country. Remember, if you use the wrong naming convention WordPress won’t be able to use your translation, so double-check if necessary.
  8. Save your new language file in the wp-content/languages/themes/theme_name-fr_CA.mo . In this case, we are translating a theme called SoundRise in French-Canada. The filename will be soundrise-fr_CA.mo . See screenshot: http://d.pr/i/iVUn
  9. Some strings is located in the plugin "soundrise-music". You need to repeat steps 4 to 8 as you did for the theme. The pot file in the plugins/plugin_name/languages folder, and you will save the mo file in the wp-content/languages/plugins/plugin_name-fr_CA.mo

Setup Wordpress to read your translation

OPTION 1. IF YOU ARE USING 2 LANGUAGES ON YOUR SITE:

  1. Make sure the language value you are translating is set in your translation WordPress plugin. In this case, we are using WPML plugin/
  2. - Go to WP-admin > WPML > Language. Add/Edit the language you want to translate (http://d.pr/i/ssZZjo) and click "Edit languages"
  3. - Make sure that the default locale is corresponding to your .mo file you previously saved. In this case, it will be fr_CA since my .mo file has been named: soundrise-fr_CA.mo (where soundrise is the name of my theme and fr_CA is my default locale, separated by a dash) See screenshot: http://d.pr/i/wNxvu7

You are done!

OPTION 2: IF YOU ARE USING ONLY 1 LANGUAGE ON YOUR SITE

You’ll need to make sure your wp-config.php file settings match your language files. Edit the file wp-config.php which is located in your root folder (See screenshot: http://d.pr/i/1fQmH) You’ll need to open the wp-config.php file and set your language accordingly, like this:

 


/** * WordPress Localized Language, defaults to English.  *  * Change this to localize WordPress. A corresponding MO file for the chosen  * language must be installed to wp-content/languages. For example, install  * es_ES.mo to wp-content/languages and set WPLANG to 'es-ES' to enable Spanish  * language support.  */ define('WPLANG', 'fr-CA');

 

 

Share your language files with others

If you’ve already translated a theme then many of our users would be delighted if you could share your translation files with the community. Just get in contact with us via our Helpdesk ticket system and we will include the translation files in the next theme update if possible.

 

Translation tips: Character Encoding

If you’re used to working in HTML or through the WordPress editors then there are a few areas which might catch you out when creating the translations; here’s a few tips to help you get things done: First of all, any localizations should use UTF-8 encoding. This is one of the reasons we recommend Poedit; this kind of seemingly minor issue is already accounted for in a dedicated program. If you were to edit the files via a standard, simple editor like notepad, then the default settings will usually use different encoding. You won’t actually notice this when working on the file, but once you save it you’ll notice that all your translated elements are displaying the identifying string rather than the original or new language. You can just open and resave the file with the proper encoding, but using a dedicated program will prevent this happening in the first place, so it’s probably the safer solution! When writing your translations you should write your translations plainly; that is, avoid escaping accented and special characters with HTML character entities, save for a select group that are expected to be escaped to avoid conflict with XHTML markup: angle brackets (< & >), and ampersands (&). In addition, there are a few other characters that function better when escaped, such as non-breaking spaces ( ), angle quotes (« and »), curly apostrophes (’) and curly quotes. When we create multilingual sites, we need to remember that translation is not everything; localization goes beyond just translating words and expands to include adapting the site to a different language, country and conventions. Some words simply don’t mean the same thing or carry the same implications as other languages, so don’t translate literally; translate organically; try to get a feel for the meaning behind the original text, and capture that spirit in your translation.

11. How to duplicate Events, Playlists, Artists, Posts and Custom-Posts

First, you need to install a plugin called "Duplicate Post". 
- Go to WP-Admin > Appearance > Install Plugins > Add New
- Search for "Duplicate Post", install and activate it.

Select Custom Posts you need to duplicate.
- Go to WP-Admin > Setting > Duplicate Post
- Select the "Permissions" tab
- Check all custom posts wanted

A "clone" option is now available below each of your posts.

12. How do I update my theme ?

First of all, do a backup on your local computer. There is a lot of tool and plugins available to help you to do this. Just find one with a good rating and get it set up now, not later: https://wordpress.org/plugins/search.php?q=backup+wp

ALWAYS make a backup of your entire site before you update. Usually. the update installs within seconds and cause zero problems, but it's better to be safe than sorry.

How to upgrade?

The first thing to know is that if you have modified PHP, CSS, JS files into the core theme, the update will overwrite what you did (it's why we suggest doing your modifications in the child theme).

The update will NOT affect your content such as your blog post, photos, videos, option theme settings, WordPress settings. Basically, the update replaces the PJP, JavaScript and CSS files of the theme, not your database, and not the WordPress core files.

OPTION 1 - AUTOMATIC UPDATE:

  1. Download and Install the official Envato Market WordPress plugin here
  2. Follow the instruction on the Envato Market WordPress plugin official page.

OPTION 2 - MANUAL UPDATE: 

1. Redownload the theme files on ThemeForest (ThemeForest always have the latest version of the theme). So login to your Envato account, then go to Downloads, and download "Installable Wordpress file Only" package.

2. Go to Wp-Admin > Appearance >  Themes and activate another theme such Twenty Fifteen.

3. Delete the Theme you want to update. (Yeah, you must delete the theme before re-uploading the same theme).

4. Go to WP-Admin > Appearance > Themes > Add New and Upload the theme .ZIP file you've just downloaded from ThemeForest.

5. Activate your theme by clicking the "Activate button".

6. Make sure to reactivate the plugins by going to WP-Admin > Plugins. 

7. If one of your plugins has not been updated (ex: Visual Composer), go to WP-Admin > Plugins and delete the plugin then go to WP-Admin > Appearance > Install Plugins and reinstall the plugins. Make sure to "activate" it again.

OPTION 3:

If deleting a theme makes your nervous, or you have an issue when uploading the theme via the WordPress dashboard, you can upload it manually by FTP.

1. Redownload the theme files on ThemeForest (ThemeForest always have the latest version of the theme). So login to your Envato account, then go to Downloads, and download "Installable Wordpress file Only" package.

2. Unzip the zip file on your computer

3. Rename the root folder to something like "themename-new".

4. By using an FTP software (such as FileZilla), connect to your FTP.

5. Upload the folder to .../wp-content/themes/ (so you should have /wp-content/themes/themename-new/)

6. Once everything has been uploaded, go to WP-Admin > Appearance > Themes and activate your new theme.

7. Make sure to reactivate the plugins by going to WP-Admin > Plugins. If one of your plugins has not been updated (ex: Visual Composer), go to WP-Admin > Plugins and delete the old plugin.

8. Go to WP-Admin > Appearance > Install Plugins and reinstall the plugins. Make sure to "activate" them again.

13. How to embed a SoundCloud Player into my pages ?

To setup SoundCloud on the homepage, you have several options but here are 2 easy options: 

1) Embedding the player into a text area widget Go to soundcloud.com. follow this FAQ to embed the player. http://help.soundcloud.com/customer/portal/articles/243751-how-can-i-put-my-sound-on-my-site-or-blog-
Once the iframe code is copied into your clipboard, go to wp-admin > appearance > widget. Drag/drop the TEXT widget into your homepage one or two column zone. Paste the iframe code into the box. Here's a screenshot: http://d.pr/i/ZzLb  

2) Use a SoundCloud player plugin/widget:
Install a plugin such as SoundCloud is Gold (see screenshot: http://d.pr/i/I7pK ) Activate the widget then go to Appearance > Widgets and drag/drop the widget on your homepage one or two column zone.