Gumbo - A WordPress Podcasting Theme
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:
- Installing WordPress - This should cover multiple ways of installing WordPress on your server.
- The Official WordPress Codex – The official Codex includes tons of info on WordPress, it's the best place to start from!
- FAQ: New To WordPress – the most popular FAQ’s regarding WordPress.
- WordPress Installation Tutorial
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:
- Login to your WordPress admin panel.
- Go to Admin panel > Appearance > Themes > Add New > Upload Theme.
Click on Choose File and select
- Click on Install Now.
- When your theme is successfully installed, click Activate to activate the newly installed theme.
- Using an FTP client, login to the server in which your WordPress website is hosted.
Using the FTP client, navigate to the
/wp-content/themes/directory under your WordPress website's root directory.
- Upload the entire theme folder into the themes folder on your server.
- 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.
- 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.
- 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)
- 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:
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.
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.
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.
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:
- 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.
- Using the Seriously Simple Podcasting plugin - The SSP plugin is quite popular as well.
- 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.
- 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 decide which post "Type" you'd like to use. SSP intially creates a custom post type named "Podcasts" that is completely separate from the default WordPress "Posts". You can either force to change the post type back to the original posts section or to continue use the "Podcast" post type. If you want to switch back, 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.
Note - In case you decide to stick with the "Podcast" post type, please make sure to edit all the areas where you add a list/grid of posts with the Elementor page builder, and make sure to change the post type on the "Query Settings" tab to "Podcast"
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:
- 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>
- 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:
- 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)
- 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:
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.
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:
- Download the latest theme files.
- Extract it and locate
- 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.)
- 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 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.
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:
- 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.
- Store all languages alternatives for each post in the same post (e.g. qTranslate).
- Manage translations on the generated page instead of using a post context (e.g. Transposh and Global Translator)
- Plugins that direct you to external translation services (e.g. Google AJAX Translation)
- 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
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
Frequently Asked Questions
If you've just installed the theme, but want your new site to look exactly like our Live Demo - you should import the demo data via the "Appearance > Import Demo Data" section. Once imported, your site should look exactly like our demo and have the same content. You can then start removing unwanted posts or content and add your own.How to edit the homepage?
If your homepage is simply a list of posts and cannot be edited, simply create a blank page and set it as the static front page via the "Settings > Reading" panel. This should allow you to have more control on the layout and content of the homepage and will allow to edit it with Elementor.Where can I change the "Latest News" title on the Homepage?
If you display a dynamic index page instead of a "Static Front Page", you would have a "Latest News" heading within the header. If you want to change it, check out the question above and set a new static front page.Do I have to use a specific plugin for podcasting?
Not at all! If you use any one of the popular Podcast Hosting companies (Blubrry, Castos, Podbean, Libsyn, Spreaker, SoundCloud etc..) you do not need to make any change. Our themes support almost any provider out there so make sure to read the "Podcasting" section of this documentation. Also, you can host the audio files within your Podcast Website (via FTP or the WordPress media section) and still display your episodes this way.What are the recommended image sizes and how do I change these?
The recommended image sizes are defined within the functions.php file and are:
- 1. Podcast Image on Grid/Masonry Layout - 800x500 px
- 2. One Column Podcast Element Image - 350x325 px
- 3. Slider / Single Podcast Posts Background - 1400x700 px
If you want to change one of those, make sure to apply the change of dimensions within the functions.php file of your theme (or Child Theme) and then run at least once the "Force Regenerate Thumbnails" plugin to update all images.
Note - In addition to the image sizes noted above, we also use a more flexible size for the "Title Area" background image. This can be 1920px wide (to fit a wide range of screen sizes) and anywhere between 500px to 1200px tall. The height of those images is basically fluid and is defined by the top/bottom padding you are using on your "Title Area".How do I change that default background image?
If you want to change the large background image (with the microphone) that appears on most pages or posts, you would need to change the default global image in the "Appearance > Customize" area. Note that there is more than only one default image, as it can vary by the actual location of the image
Still have more questions? Please visit our main FAQ page, or simply shoot us an email!
Thanks again for purchasing our theme. Feel free to contact us with any questions, suggestions and issues!Follow Us Subscribe to our Newsletter Support