Documentation

Gumbo - A WordPress Podcasting Theme

By SecondLineThemes
Support

Thank you for purchasing our product. We have put plenty of hard work in it, and hope you like it. If you have any questions or issues that are beyond the scope of this documentation, please contact us for support.

General WordPress Info

If it's your first time using WordPress, take a moment to get a quick understanding of this new environment. Luckily, WordPress is one of the best CMS options out there (as a matter of fact, it runs on more than 28% of the entire internet!) If you already know how your way around WordPress, feel free to skip to the next section. Otherwise, please go over the following links and videos to make sure you know everything needed in order to start.

Below are all the useful links for WordPress information:

Theme Installation

Once you've downloaded the installation files, extract it and locate a file called Gumbo-Theme.zip. You can install the theme by using one of two installation methods:

WordPress upload
  1. Login to your WordPress admin panel.
  2. Go to Admin panel > Appearance > Themes > Add New > Upload Theme.
  3. Click on Choose File and select Gumbo-Theme.zip.
  4. Click on Install Now.
  5. When your theme is successfully installed, click Activate to activate the newly installed theme.

FTP upload
  1. Using an FTP client, login to the server in which your WordPress website is hosted.
  2. Using the FTP client, navigate to the /wp-content/themes/ directory under your WordPress website's root directory.
  3. Upload the entire theme folder into the themes folder on your server.
  4. Once uploaded, navigate to Dashboard > Appearance > Themes in the WordPress Dashboard and hit Activate right below your newly uploaded theme.

With either of the above two options, make sure you are uploading the Gumbo-Theme.zip file! (It should be less than a few MBs), and not a larger .zip file that contains the entire theme package along with the documentation and Photoshop files. If you upload the wrong file you will most likely get an error such as: “Error: missing style.css stylesheet.”

Note - If you receive any kind of error message after installing the theme or a plugin, please contact your hosting provider and ask them to upgrade the PHP version installed on your server to either 5.4, 5.6, or even better, version 7+.

Installing the Recommended Plugins

After installing your theme, you will be prompted to install several plugins. Click on the "Begin Installing Plugins" text link to install the plugins. If you don't see this prompted message, navigate to Appearance > Install Plugins and continue from there.

Note: We strongly recommend installing all plugins upon the initial installation. Once you are start working with the theme and plugins, feel free to deactivate and remove any plugins you don't need. Some plugins are really important in terms of functinoality (although none is really mandatory, you may only lose a couple of features without some plugins) so make sure to install all of them and only remove the ones you really don't need.

Importing Demo Data

You can import the demo content under Appearance > Import Demo Data. Tick the relevant checkboxes, and then simply click on "Import Demo Data". After doing that, wait until the importer notifies you the import process is successful. Please click the import button only once and wait, it can take a few minutes so make sure not to leave the page or refresh it. If you click on the import button mulitple times it will duplicate the menu items under Appearance > Menus. However the pages themselves will not be duplicated.



Importer FAQS
  1. Import doesn't complete - If the import process times out or does not finish, please run the importer again. Running the importer mulitple times may duplicate your menu items. If you run the importer again, make sure to delete any navigation menus under Navigation > Menus. You will not have delete any pages as those will not duplicate.
  2. Importer showing PHP errors - If the importer shows PHP errors, please make sure to turn the WP_DEBUG variable off in the wp-config.php file. Also, make sure that the PHP version on your server is 5.4+ (5.6 is much better, and version 7+ is the best option currently)
  3. Importer showing a 404 error - If the importer redirects you to a page non-found, please make sure to re-save your permalinks under Settings > Permalinks. Then, try increasing your PHP memory and timeout limits and try using the importer once again.

Setting Up The Homepage

If you don't want to import the Demo Data, you should notice that the homepage initially display an index of your latest posts (And the page would be labeled "Latest News").

Obviuosly, if you want to enjoy the full features of this theme and allow more flexibility editing the homepage, you would need to change that into a static page.

In order to do so, you will have to create a blank page, and name it as you wish. We have used "Home", for our example below. Then, navigate into the "Settings > Reading" part of your Admin Panel, and make sure to select a static page to show on the homepage and save the new settings:


Theme Options

You can easily customize the theme options under Appearance > Customize. This includes theme colors, images, fonts and typography, and many general settings.


Changing the Logo

You can easily adjust the logo in the Theme Customizer ( Appearance > Customize ) under the section "Header" and sub-section "Logo".

To change your logo, click on "Change Image" and choose your new logo. Make sure to adjust the "Logo Width" to match your new logo.



Changing the copyright text / link

You can easily adjust the copyright text and link under Appearance > Customize > Footer > Copyright Text.


Navigation / Menu

You can create & manage your navigation menus under Appearance > Menus.


Step 1: Create a Menu

To start, create a new menu. You can click on text link "create a new menu". Then, enter in a menu name and click "Create Menu".


Step 2: Set the Menu Location

After you have created your menu, you need to select the Theme Location. You can do this by going under the "Manage Locations" tab at the top. Then select a menu for example "Primary Menu" or "Mobile Menu" and click "Save Changes".


Step 3: Add pages to your Menu

You can then start adding pages and links to your menu. After you click "Add to Menu", it will move the menu item menu on the right. You can drag menu items around to order them. Or customize/delete the menu items by clicking on the down arrow on the right. Make sure to save the menu when you are done editing it.


Adding Sub-menus

You can make multiple level's of sub-menus. All you need to do is drag the menu item that you want inside the sub-menu under-neath the parent menu item. There will be an option to indent the item, so that the sub-menu item looks like it is pushed inside of the parent menu item. See example, "Contact" is in a sub-menu of the parent page "Home":


Elementor Page Builder

This theme is powered by the page builder "Elementor". Check out the full Elementor documentation here: https://docs.elementor.com


Using the Page Builder

You can edit any page with the page builder by clicking the "Edit with Elementor" button.

From there you can add new Elements or editing elements by clicking on them. Just select an element and then the panel on the left will display options:


Changing Background Colors and Images

To change a background color or image, you will generally need to change the "Section" or "Column" settings. These options would appear under the "Design" tab one the left side.


Adding Elements

You can add new elements by clicking the tabs icon on the top right of the Elementor sidebar. From there you get a list of elements. Choose any element and drag it onto your page where you want it


Adding Pre-Saved Templates

We have saved custom built-in templates in the Elmentor template manager. Once you import the demo data, you should find the custom templates in your Elementor Library. In addition there are many other free templates available that can be be used to re-create various pages or sections of the site. Click on the tempaltes library button to open the layout options:

Templates can be used to re-create various pages or sections of the site. Click on the layouts button to open the layout options:

Then click on the "Default Templates" tab in order to see all the built-in templates.



Page Options

You have additional page options at the bottom of each page and post which can be used to adjust the sidebar display and header display.

Note: You can also choose to use Elementor to edit the regular posts as well. To do so, simply enable this option in the Elementor plugin settings and start editing your single posts with the plugin.

Podcasting / Posts

The main purpose of this theme is for Podcasting, but it can obviously be used for any other purpose you may need. There is great support for Audio, Video, Featured Images, Background Images and more, so all that ensures you have sufficient flexibility for creating your site in any way you want.

There are several option of setting up a podcast with this theme:

  1. Using the Blubrry PowerPress plugin - This plugin is probably the most popular podcasting plugin. Our theme should fully support the plugin and allow you to add in media files to any post.
  2. Using the Seriously Simple Podcasting plugin - The SSP plugin is quite popular as well.
  3. Using the Simple Podcast Press plugin - The SPP plugin is great when you need to import an existing show via the iTunes URL or RSS feed that already contains lots of episodes. It also has its own customizable audio player with tons of features.
  4. Using embedded audio files from external providers (Such as: SoundCloud, MixCloud, Libsyn, YouTube, Vimeo, direct link to an MP3 file etc.) - This option can be easily achieved by adding your embed code into the External Embed Code field on each post.


1. Set up a post with PowerPress

If you decide to use PowerPress, you should immedeately notice the additional metabox automatically added to the post pages:


You should fill in the URL to your MP3 file manually (for example: http://your-site.com/wp-content/uploads/2017/11/audio.mp3) or alternatively connect your Blubrry account in order to choose the files directly within WordPress.

Note - If you wish to display the player exactly like in the theme demo, please ensure to modify the PowerPress 'Website Settings' and set to hide the audio player by default. This way the theme would automatically insert the player in the location showed on the demo. If you just want the media player to appear on the content area of each post, simply select that option within PowerPress



2. Set up a post with Seriously Simple Podcasting

If you prefer to use Seriously Simple Podcasting, you should first change the default post type. SSP intially creates a custom post type named "Podcasts". You'll need to change the post type back to the original posts section, so to do that, please navigate to the Seriously Simple Podcasting settings, and select the Post setting:


Once this is done, you'll see a new metabox on all your posts:


You should fill in the URL to your MP3 file manually (for example: http://your-site.com/wp-content/uploads/2017/11/audio.mp3) or upload a new file into your WordPress server.



3. Set up a post with External/Embedded media

In case you wish to adding your media manually, can use the External Embed Code field available within the Post Settings area:


In there, you have a few options to insert media:

  1. External Embedded Code - You can insert the embed code traditionally available on platforms such as YouTube, Vimeo, SoundCloud, MixCloud and so on. This would typically look like this:
    <iframe src="https://www.youtube.com/embed/Rk6_hdRtJOE?rel=0" frameborder="0" allowfullscreen></iframe>

  2. MP3 Audio File - To add your own MP3 files, simply add-in the link to the file inside the field in the Audio Shortcode format. Remember, these files can be hosted on your server, or on any external server such as AWS for example. It should typically look like this:
    [audio mp3="https://gumbo.secondlinethemes.com/wp-content/uploads/2017/07/aj-jazz-trumpet.mp3"][/audio]

  3. MP3 Audio Playlist - To add your a new MP3 playlist, you'll need to upload your MP3 files to WordPress (Currently WordPress does not support external URLs in a regualr playlist) and then add-in the shortcode to the media files IDs (Which can be found in the Media panel) It should look like this: (Include 5 separate audio files, all hosted on your WordPress media section)
    [playlist ids="500,501,502,503,504"]

  4. Video File - To add your own video files, simply add-in the link to the file inside the field in the Video Shortcode format. Remember, these files can be hosted on your server, or on any external server such as AWS for example. It should typically look like this:
    [video src="http://yoursite.com/wp-content/uploads/2017/11/Northernlights2_HD.mp4"]

Note: If you're planning to display a Video on your post pages, please make sure to select the Video Post-Foramt when creating the post. (This is located on the right side, bellow the Publish section.)





Page Builder Elements

There are several custom elements in the Elementor Page Builder that we have created: the "Post Grid", "Post Slider" and "Single Post" elements. While these are quite similar, there are some differences:

  • The Post Grid addon can display a grid or a list of posts. You can display an unlimited amount of posts in various styles.
  • The Single Post addon can display one single post only. You must choose which post you are willing to show. This addon can also include an audio/media player. It is best when displayed within context of a page or in a CTA type section.

  • The Slider addon can display two or more rotating posts in a slider with animations anywhere on your page. This addon can also include an audio/media player.



Note: In each one of these addons, you will find tons of settings and design options that you can modify. Make sure to go over all the options and tabs and you'll find that it's super easy to change the layout, colors, font sizes, spacing and more!



Editing the Post's Content


Using the default WordPress Editor

To add-in content to your posts, simply use the regular WordPress WYSIWYG editor and modify the post's content as needed.


Post Settings:

Adding a Featured Image

The Featured Image appears on the post grid, post list, single post element, and in all archive pages. To add the image, simply click "Add Media" and upload the image. Then click "Set Featured Image" and select your image. The last step is to click "Use as featured image". See the example below.


Adding an Image Gallery

You can add an image gallery by editing the "Post Settings" at the bottom of the post. Just click "Add New" under the Image Gallery and add-in as many images as you need.

Then make sure to select the Post Format "Gallery".


Change the default Title Area background image

You can set a different Title Area background image for each post. To do so, simply upload an image to the Title Area Background Image field found in each episode post.

Updating The Theme

Note - In case you've made any customizations to the theme files they might be lost, so it is always recommended to use a Child Theme for customizations. It is always recommended that you make a full backup before changing/removing files. However, all of your site's information and content (such as posts, plugins settings, customizer settings etc.) should be saved within the database.

You can update your theme by performing the following steps:

  1. Download the latest theme files.
  2. Extract it and locate Gumbo-Theme.zip.
  3. Delete the current theme via the Apperance > Themes panel. (Note: This would not delete any content, but if you have made any customizations to the theme files they could be overwritten.)
  4. Upload and install the latest version of the theme.


Optional: If you have purchaed this theme from Themeforest, you can use the Envato Market plugin to make automatic updates.

Child Theme

Child Themes are separate themes that rely on a Parent Theme for most of their functionality. If you are using a Child Theme, WordPress will check your child theme first to see if a specific functionality exists. If it doesn’t, it will use the parent theme. This is great because it allows you to modify or override only what you need, without losing anything when updating the parent theme.

Child themes should always be used if you plan on modifying your theme files.

If you plan to edit the theme files, like style.css, it'd be best you install both the main theme and the Child Theme as well, then activate the Child Theme.

Here's some more info on Child Themes and how to use them properly.

Theme Translation

This theme is ready to be translated to any language. The easiest way to translate is via a Translation WordPress Plugin. Check out wordpress.org for a list of translation plugins. Our current recommendation is the plugin Loco Translate. Read more about Loco Translate Here

You can learn more about translating WordPress via the Translating WordPress Documentation.


Need to support Multiple Languages?

Here are some of the Multilingual WordPress Plugins that will allow you to add multiple languages:

  1. Manage multilingual posts in one post per language (e.g. WPML - paid, xili-language, Polylang or Bogo). Translations are then linked together, indicating that one page is the translation of another.
  2. Store all languages alternatives for each post in the same post (e.g. qTranslate).
  3. Manage translations on the generated page instead of using a post context (e.g. Transposh and Global Translator)
  4. Plugins that direct you to external translation services (e.g. Google AJAX Translation)
  5. Plugins like Multisite Language Switcher, Multilingual Press, and Zanto, link together separate WordPress network (multisite) installations for each language by pinging back and forth.

Missing Font Characters

If you notice any font characters missing, you will need to select additional Font Subsets. You can manage this under Appearance > Customize under the Typography tab.

Note: Some fonts do not support all font sub-sets. If your font does not support your language, you will need to choose another font that supports your font characters.

If you prefer to locally translate your theme, please find the language .POT file in languages folder wp-content/themes/Gumbo-Theme/languages/

Customizations

Any questions regarding major customizations of themes are not included in theme support. It is up to the buyer to make any necessary customizations they need.

We highly recommend Codeable for any customization work. This is the most professional platform to find reliable WordPress experts.

If you would like to hire us for custom development, please contact here: http://secondlinethemes.com/contact/

If you have questions that are beyond the scope of this help file, contacct us for additional support.


Tips on Customizing CSS

If the customization you want to change isn't listed in the Theme Customizer, check the style.css file. We have a table of contents at the top that points out all of the sections within theme. You can also look-up styles using the "Inspect Element" tool in FireFox, Safari, Chrome, Edge etc. This will allow you to edit additional places within the theme.

How to use Inspector for Safari & Chrome to look-up styles in the style.css file: https://www.youtube.com/watch?v=nOEw9iiopwI






Thanks again for purchasing our theme. Feel free to contact us with any questions, suggestions and issues!

Support