Mundana WordPress Theme Documentation

Installing WordPress

This is a Wordpress theme, so you must install Wordpress first. There are several ways to install WordPress but the easiest way would be to use one of the one-click autoinstallers available from you hosting company. Click here to learn how to install WordPress with the most popular autoinstallers, WordPress Toolkit, Cloudron, Fantastico, Installatron, and Softaculous.

Theme Installation

1. Go to your WordPress Admin Panel & Log in (wp-admin)
2. Go to Appearance/Themes/Add New
3. From top, Click on Upload Theme
4. Choose the theme ZIP file you've downloaded & Click Install Now
5. Click on Activate to active the theme

License Key

• As soon as your theme is activated you will be prompted to enter the license key.
• On activation, you will notice a new menu in your WP dashboard, called Theme Setup which provides info about your Account, License Key settings and a short guide on what to do next.
• The Demo Importer will also become visible in Appearance section.
• You can activate as many WP local licenses as you need.
• You can white label the Account menu for a client's website.

Plugins Installation

Demo Importer

1. Make sure all required plugins are installed and activated.
2. Navigate to WordPress Dashboard/Appearance/Import Demo Data and proceed with the import. (Note: Unless you have your license key activated and the Demo importer plugin active, you will not be able to see the Demo Import section.)
3. After successful message, wait for a few seconds, then you can visit the website. You may need to refresh if it takes too long for the first time.
4. You may experience a slower page load soon after import, do not worry, it will all go back to normal in a couple of minutes.

After Import

You should now have a full website ready. All you have to do is change it with your actual content, images and options. In order to do this, please, navigate to:

• Dashboard/Pages (pages)
• Dashboard/Appearance/Customize (options)
• Dashboard/Posts (blog)

Menus

Before adding items to the menu, you must first define it.

1. Navigate to the WordPress Dashboard.
2. From the ‘Appearance’, select the ‘Menus’ option.
3. Choose Create a new menu at the top of the page
4. Enter a random name in the Menu Name box
5. Click the Create Menu button.

That’s it! You’ve just created a custom menu. Now let’s add some items to it!

1. Notice the pane entitled Pages.
2. Within this pane, click the View All link to display a list of all the published Pages on your site.
3. Choose the Pages that you want to add by clicking the checkbox.
4. Click the Add to Menu button located at the bottom of this pane to add your selection(s) to the menu that you created in the previous step.
5. Click the Save Menu button once you’ve added all the menu items you want.

Great! Now the final step, make the menu visible in site. “Mundana” theme has 2 menu locations: main menu & extra menu.

1. Scroll to the bottom of the menu editor window.
2. In the section titled Theme locations, click the check box for the location where you want your menu to appear:

3. Click Save menu once you’ve made your selection.

The menu should be now visible in website.

Home Layout

“Mundana” does not have a complicated layout. Basically, all you have to do is post. The articles will nicely arrange in their order:

How to stick a post

• Go to Dashboard/Posts
• In the right side menu, Click Edit link
• Click Stick this post to the front page option

Do not set more than 1 sticky post at a time.

Popular Posts

“Mundana” displays popular posts in home, categories, tags by the number of claps. Make sure you have our plugin WP Applause Button installed and active.

Category Image

“Mundana” displays a list of categories with thumbnails. In order to assign thumbnails to categories, make sure you have Categories Images plugin installed. Then navigate to Dashboard/Posts/Categories, select each category and assign the appropriate image.

Post Layouts

“Mundana” has 4 post layouts you can choose from:

• default
• tall featured image
• hidden featured image
• full width featured image

Each post can be assigned a different layout. Simply edit the post and check the desired layout from the right sidebar:

Customizer (Theme Options)

Navigate to Appearance/Customize/Mundana from your WordPress dashboard. You will be taken directly to the Customizer where you will be able to set all theme options:

Theme Style

From Appearance/Customize/Mundana/Theme Style you have the option to set the following:

• body background color
• navbar background color
• navbar text color
• container width
• article links color
• comments accent color
• submit button color
• home featured post background
• home featured post color
• sidebar title

Typography

From Appearance/Customize/Mundana/Typography you have the option to set the following:

• body font family, size, color
• logo font family, size, text-transform, letter-spacing
• article font family, size, color, headlines
• home featured post font family, size, line-height

Sidebar Title

Sometimes your website title may be too long so you’ll need to control the font size of the sidebar’s Popular title.

To do that, please, navigate to Appearance/Customize/Mundana/Typography and scroll to Sidebar Title. Here you can change the font to an appropriate size.

Logo & Nav

From Appearance/Customize/Mundana/Logo & Nav you have the option to set the following:

• logo image upload
• header search on/off
• justify main menu on/off

Social Links

From Appearance/Customize/Mundana/Social Links you have the option to set the following:

• facebook link
• twitter link
• youtube link
• pinterest link
• linkedin link

These links will appear in article’s bottom bar, but you have the option to disable some or all of them, as you’ll see later:

Articles

From Appearance/Customize/Mundana/Articles you have the option to set the following:

• Disable Author
• Disable Reading Time
• Disable Article Date
• Disable Twitter Share
• Disable Facebook Share
• Disable Pinterest Share
• Disable Linkedin Share
• Disable Share
• Disable Categories
• Disable Tags
• Disable Related Posts
• Disable Post Excerpt

Article Post Excerpt

Mundana’s default & tall image article layout features by default post excerpts:

The reason behind this is the option to serve as an introduction to the subject or topic of your article. Unless you add your topic in post excerpt, the first words of the article are automatically triggered.

Disable Article Post Excerpt

If you don’t need this option, you can easily disable it. Please, navigate to WordPress Customizer via Appearance/Customize/Mundana/Articles, and check Disable Excerpt.

Article Alert Bar

From Appearance/Customize/Mundana/Article Alert Bar you have the option to set the following:

• Disable Social Links
• Disable Up Next

Newsletter Alert Bar

From Appearance/Customize/Mundana/Article Alert Bar you can disable social links and still keep your alert bar for announcements or even newsletter forms, simply edit the textarea (supports HTML):

The shortcode for the newsletter form can be obtained through your newsletter plugin. The example shown in screenshot is using Mailchimp for WordPress plugin but you can, of course, use your own newsletter client. Contact us if you need help styling it.

Footer

From Appearance/Customize/Mundana/Footer you have the option to set the following:

• left footer text
• right footer text

Both support HTML.

Tracking Code

From Appearance/Customize/Mundana/Footer you have the option to set the following:

• add tracking code before </head>
• add tracking code before </body>

Other

From Appearance/Customize/Mundana/Other you have the option to set the following:

• fallback for Schema.org image
• disable Theme Schema
• disable categories list (appearing on homepage)

Mailchimp Newsletter (after article)

Assuming you already have MailChimp for WordPress plugin active and its API key set, navigate to MailChimp/Form and paste the following code:

<h2 class="secondfont mb-3">
  Subscribe to our newsletter
</h2>

<input type="text" name="MMERGE2" placeholder="Name" required="">
<input type="email" name="EMAIL" placeholder="E-mail" required />
<input type="submit" value="Subscribe" />

<small class="mt-2 d-block text-muted">*We value your privacy and we never spam. You can unsubscribe at any time.</small>

Then save changes. The result should be something like this:

Finally, navigate to Appearance/Widgets and drag “Mailchimp Sign-up Form” in “After Article” widgets area:

Don’t forget to save. That’s it. You can visit a random post and see the newsletter form at the end of your article.

Widgetized Areas

Navigate to Appearance/Widgets/. You will notice “Mundana” has 5 widgetized areas.

In our demo we have a widget in the “After Article” area for our newsletter form but you can of course, add your own widgets:

Login & Register Modals

The reason behind this approach is making the publishing experience for your guest/users as smooth as possible. Your visitors can post as a guest or as registered users. We wanted to provide a quick ajax sign up in order to keep your potential publishers on the website.

To enable the login/register modals, you must have Ajax Login & Register plugin installed and active.

Then visit your menu and add a “Login” or “Register” item:

You can set the options of the plugin by navigating to Dashboard/Settings/Login & Register modal:

Show/hide menu links if guest or logged in

This is a great feature for your website. You have the option to

• show a menu link to guests only
• show a menu link to logged in users only
• hide a menu link from guests only
• hide a menu link from logged in users only

In example, our demo shows a “My Account” link to logged in users only.

How can we do that? We add a class lrm-show-if-logged-in to the menu item:

On the contrary, to hide a menu link from logged in users, we use lrm-hide-if-logged-in.

Confused? Let’s sum this up in a simple way:

• hide a menu link from logged in only: lrm-hide-if-logged-in
• show to guests only: lrm-hide-if-logged-in
• hide from guests only: lrm-show-if-logged-in
• show a menu link to logged in only: lrm-show-if-logged-in

Facebook Login

Ajax Login & Register plugin is compatible with WP Facebook Login. Install, activate and navigate to plugin’s settings. You will be asked to enter Facebook app ID & Secret key.

How to:

• Login to FB My Apps
• Click “My Apps” from top right menu.
• Click “Create new app”.
• Enter “Display name” such as My Website Login and click “Create App ID”
• Select “Integrate Facebook Login”:

• Enter the details and make the app live ON:

• Enter the details in WP Facebook Login settings and wait for a few seconds before your login/register modal will show the Facebook alternative login.

Guest/User Publishing

Activating the required plugin

“Mundana” is made compatible with the free version of WP User Frontend to serve your possibility of allowing guests/users to publish posts on your website. Make sure you have the free version installed and active. Follow the set up process, let the plugin create the necessary pages.

Notes

The plugin usually installs the necessary pages on activation. However if you missed that part, create them yourself. You will only need these pages:

• A page named My Account with the shortcode: [wpuf_account]. This page should be linked from the menu to logged in users. This is where the users can edit their profile and publish/edit posts:

• A page named Edit with the shortcode [wpuf_edit].

• A page named Login with the shortcode [wpuf-login].

• a page named Registration with shortcode [wpuf-registration]

Set your publishing options

Next, navigate to Appearance/User Frontend and set the options. Here are the screenshots of the options set in our demo to make your work easier:

Create “Publish a story” page

Now that you have completed the settings, let’s create a the “Publish a story” page, where your guests/users will actually publish their posts.

Navigate to Appearance/Frontend/Forms. Create a form and copy the generated shortcode. Paste this shortcode in a newly created page named Publish a story (or whatever name you wish).

If you want to add a note for the non logged in users, you can wrap the paragraph between [visitor_access]...[/visitor_access]. Our demo has such a note where we recommend te guests to sign in or register.

Frontend output:

That’s it! You now have a full guest/users publishing system.

Follow authors addon

If you want to offers users the option to add favourite authors, we’ve built an addon for Mundana theme: Wow Follow Author plugin. Just install and activate. Authors will be assigned a “Follow” button and followers can bookmark their profiles in their account:

Important

You will not be able to see the follow buttons in your own posts/author profile. If you want to test the plugin, create a test user and log in as that specific test user.

Bookmarks addon

Let your visitors/logged in users to bookmark your posts and read later them later. Mundana uses Favorites plugin to manage bookmarks.

Install, activate and visit Settings/Favorites.

To restrict the bookmark option to logged in users only, go to Users tab, deactivate Anonymus Users and check Show Buttons and display Modal for Anonymus users. Then in “Edit the Modal Content below”, paste:

[lrm_form default_tab="login"]

Use the following settings to replicate Mundana’s minimalist bookmark style:

Delete me addon

If you want to offer users the option to delete their account, we’ve built and addon for Mundana theme: Wow Delete Me plugin. Install, activate and navigate to its settings.

Make sure you follow the red arrows, you can leave the rest as is:

Note for Reassign post to ID

If the user wants to leave his/her posts on your website, you have to enter the ID of the newly assigned author. So, we recommend you to create a user with author capabilities, name it Guest or whatever you like and grab its ID:

That’s the ID to be entered in Reassign post to ID field.

Front end result:

Local avatars addon

Mundana is compatible with WP User Avatar. Let users upload their avatars from the front end when Gravatars are empty. Activate the plugin and visit your account to test it:

WordPress not sending emails?

This happens. Post SMTP plugin will help you fix this issue. It has a powerful Setup Wizard for perfect configuration to send e-mails through your WordPress website.

Contact Form

“Mundana” uses Contact Form 7 plugin to showcase the contact form in demo, but you can, of course, use any plugin you wish. For Contact Form 7 here is the form content:

<div class="row mb-4">
<div class="col-md-6">[text* your-name placeholder="Name"]</div>
<div class="col-md-6">[email* your-email placeholder="E-mail"]</div>
</div>
[textarea* your-message placeholder="Message"]
[submit "Send"]

<style>
.wpcf7-form-control, .wpcf7-form textarea {width:100%;}
.wpcf7-form textarea {height:200px;}
</style>

Translate Theme

The theme is translatable. All you have to do is to install a specific plugin so you can easily translate the theme in your own language. We recommend you Loco Translate plugin.

Icons

The theme has Font Awesome integrated. This means you can use any icon from this list anywehere in your site with a simple code.

Images

You can get free images for your website at Unsplash.com.

White Label Option

Agencies and freelancers who work on client projects can hide confidential information about their account and license by flagging a license as White Labeled. Click here to learn more.

Get Support

This documentation is always evolving. If you have questions, please, submit a ticket here.