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+.
Theme Installation Wizard
Once you activate the theme, you'll notice you'll be redirected to an installation wizard once you activate the theme -
Simply follow the wizard's instructions to install all the recommended plugins, add the theme license info (if applicable), create a child theme, and import the demo data. (You don't have to install all the recommended plugins, but it is highly advised that you do, and later on simply deactivate the ones you don't need)
Activating Your Theme License
When you make a purchase through our own shop, you will receive a license within your invoice that you can activate within your WordPress dashboard. In case you want to skip the Theme Setup Wizard, simple access the license panel via “Appearance > Theme License”.
Once activated, the license would automatically allow to update your theme directly from the WordPress “Themes” panel whenever an update is available. Also, we do provide support as long as you have an active license. If your license expires, you would need to renew it by making a new purchase in order to receive support and updates. However, the theme would continue to work even if the license is no longer valid. To summarize, and clarify a bit: your site will still be accessible, with the same theme installed, but access to updates and support would be unavailable, so it is highly recommended to renew your license.
Installing the Recommended Plugins
Once your theme is installed and activated, you will be able to install the recommended plugins via the Theme Setup Wizard. In case you already closed the Theme Setup Wizard, you can always access the plugin installation screen via the "Appearance -> Install Plugins" section. This will only apear if a plugin is missing or an update is available to one of the recommended plugins.
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 > Theme Setup Wizard. The Wizard also shows up upon your initial activation of the theme itself, but you can go back to it at any time.
- If the import process doesn't work properly, times out, or generate any type of errors, you can try running the importer once again. If you still cannot get the import process to work correctly, try to increase your server memory and timeout limits, and try running the import process again.
- Importer showing PHP errors - If the importer displays errors, make sure that the PHP version on your server is 5.6+ (version 7+ is a much better & faster option)
- 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.
Note - If the Theme Setup Wizard fails to import the demo data, you can use the default WordPress importer to import the theme demo data. You can access the XML file in the /demo-files/ folder that is located in the theme's root directory.
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:
The theme includes a bunch of options and settings you can modify to change your layout, colors, fonts, images, typography settings and more. To reach the customize section, navigate into the Appearance -> Customize section and go over the various sections to see all the available settings.
Changing the Logo
To change the demo Logo to your own, please access the Customizer screen under 'Appearance -> Customize' and go into the 'Header -> Logo' options tab.
Once you are in that Customizer screen, click on "Change Image" and upload your new logo. You can also set your custom logo width and position in that section.
Modifying the 'Copyright' section in the footer
To make changes to the Copyright section in the bottom of your footer, simply access the Appearance -> Customize -> Footer -> Copyright Text screen and include any text or HTML links you may need in that area.
Elementor Page Builder
Some of the pages and elements seen in the Live Preview of this theme are controlled by the "Elementor" page builder. You don't necessarily have to use the page builder, but it is highly recommended and can be a huge time-saver. Feel free to check the official Elementor docs here: https://docs.elementor.com
To edit any page with Elementor, simply edit the page with WordPress first, then click on the "Edit with Elementor" button.
Once you are within the Elementor editor, you will be able to add new elements into the page, modify existing pages, or manage and create your pages with ease. In the Elementor editor you'll see all the available elements:
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 New Elements To Pages
To add new Elements to any page, simple clck on the Elementor logo/icon on the top of the page. Once you see the list of elements on the left side, drag and drop any of them onto your page's content area.
Adding Existing/Demo Templates to Elementor
If you imported the demo data, a bunch of Elementor Templates would be available to you. You will find those templates in the main "Templates" screen of your WordPress admin panel, right under the Elmentor link. You can also access those elements when you edit any page or post with Elementor, and choose any of the demo templates or the free Elementor templates that are available within the plugin's template library by default:
You can insert any of those templates to any page edited with the Elementor page builder. You can also copy/paste elements across pages with Elementor:
Next, browse to the "My Templates" section and add/modify/delete the saved templates.
Additional Page Options
You'll find additional settings for your pages right below the content area of every page. Those settings could help you reach unique layouts on a per-page basis.
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 set (or upload) a new featured the image, click on "Add Media" and upload the image. Then click "Set Featured Image" to finalize your selection.
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.
Contact & Newsletter Forms
The theme comes by default with a few plugins that would help you increase user engagement. Firstly, the Contact Form plugin is provided so you can get emails directly from site visitors. There are two contact form options we recommend for our themes:
- WPForms Lite - WPForms is the most intuitive contact form builder plugin. It includes many features you can use in order to receive emails, register users to your newsletter, integrate marketing or automation tools, or payment providers (such as Stripe or PayPal). To create a new form with WPForms, simply go into the WPForms section, and create a new form. You can also use the pre-built templates in order to build the forms faster. Once you finish building your form, you can use the Shortcode in order to display your form on pages. Simply insert the shortcode with Elementor or the default WordPress editor and you should be all set.
- Contact Form 7 - Contact Form 7 is a popular form plugin which comes with the theme as well. We included both contact form options and you could choose your favorite one. The Contact Form 7 plugin is used in the demo and you can choose to add a form within the "Contact" screen within your WordPress Admin Panel. Once you are done creating the form, you will simply need to display the form with a shortcode on your contact page or other pages.
Adding a "Subscribe to Newsletter" section
While there are many integrations you can use for your Newsletter form (most options would work well with the theme), we chose the free "MailChimp for WordPress" plugin. Once you install the plugin, you will need to add your MailChimp API code into the plugin's options area in order to connect your form with your exisitng MailChimp list. If you don't have a MailChimp account, you can register and get a free account with a limit of 2,000 registered subscribers.
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.
The theme can be translated to any language! It is very easy to translate the theme by using a Translation Plugin. You can find those types of plugins in the official WordPress plugin repository (Plugins -> Add New). A popular option is Loco Translate. And its documentation is available Here
You can check the official WordPress info on translation by visiting the Codex: Translating WordPress.
You can use Multilingual WordPress plugins to create a site that can display multiple languages at once. Here are a few recommendations:
- WPML - One of the most popular WordPress translation plugins (paid) is available here WPML . A free alternative could be Polylang or other plugins available in the official WordPress repository.
- qTranslate - This plugins allows you to store multiple languages data within singular posts.
If you prefer to translate your theme locally, please find the language .POT file (can be modified with POEdit or other programs) in languages folder
While we do offer excellent support with our themes, we cannot provide help for major customizations or modifications that are beyond the default options included in the theme. We are happy to answer questions about the theme, installation process, options, recommended plugins and so on, but unfortunately cannot always help with custom projects beyond that scope.
We highly recommend Codeable for any customization work. This is the most professional platform to find reliable WordPress experts.
If you have questions while working on the theme, we're glad to help. Simply contact us for additional support.
How to Make Your Own Customizations
If you want to modify the theme beyond what the Customizer allows, you can easily edit your Child Theme's style.css file. You can override any of the styles directly in there. To visualize the changes in an easy way, open the "Developer" or "Inspect" tool in your favorite browser and find the changes you'd like to make:
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 "Theme Setup Wizard". 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. If, for some reason, the setup wizard did not compelte, you shall install the WordPress Importer plugin via "Tools > Import" and import the content.xml file which is located in the theme folder (you might need to extract the theme .zip file locally on your machine in order to do so)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/host 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