Xoxo - Blog & Magazine WordPress Theme

• Created date of Documentation: January - 12, 2023
• Latest update of Documentation: February - 06, 2023
• By: Frenify

First of all, Thank you so much for purchasing this template and for being our loyal customer. You are awesome!

This documentation is to help you regarding each step of customization. Please go through the documentation carefully to understand how this template is made and how to edit this properly.

A working version of WordPress.org must be installed before you can install the Xoxo. If you need help installing WordPress, follow the WordPress Codex

Before using any theme, it is important to understand how native WordPress functions work, and how to establish ownership of your new site.

WordPress links you will find useful:

• WordPress Codex: General information about WordPress and how to install it on your server.
• First Steps With WordPress: General information about WordPress.
• FAQ New To WordPress: The most popular WordPress FAQ’s

To use Xoxo WordPress Theme, you must be running WordPress 5.5 or higher, PHP 7.3 or higher (not yet compatible with PHP8) and mysql 5 or higher version. Below is a checklist of items your host needs to comply with to ensure proper Xoxo operation:

• Ensure your web host has the minimum requirements to run WordPress.
• Make sure the latest version of WordPress is up and running.
• If necessary, you can download the latest release of WordPress from the official WordPress website.

There are two methods to install the theme. If the normal installation method (a) is not supported by your web host, you will have to use the alternate option (b).

a) Normal Installation

1. Login to WordPress Admin and browse to Appearance > Themes.
2. Click on the Add New Theme (or "Install Themes" tab for older versions) and click Upload.
3. Browse your computer to select "xoxo.zip" (it's in the zip file you downloaded from ThemeForest). Click "Install Now" button.
4. Once it's uploaded, click the Activate link.

b) FTP Installation (alternate method)

1. Use your FTP software to browse to wp-content/themes folder.
2. Upload the xoxo folder.
3. Once it's uploaded, go to your WordPress Admin, browse to Appearance > Themes.
4. Click the Activate link.

PHP Configuration limits

Issues you may encounter, such as demo content fails when importing and similar issues, are generally related to excessively low PHP configuration limit settings. You can either increase these limits on your own, or contact your web host and ask to have the limits increased to the following minimums:

• memory_limit - 96M
• max_input_vars - 3000
• max_execution_time - 600
• post_max_size - 32M
• upload_max_filesize - 32M
• allow_url_fopen - ON

Verify your PHP limits

You can check them by installing the WordPress phpinfo() plugin and checking Settings. The first column refers to your installation value, and the second column refers to the limits of your host. The latter values are often lower if you have selected a cheaper hosting package.

You can always contact your host to ask what the current settings are, and have them adjusted if necessary. Some hosts will try to keep PHP limits low to conserve resources. Since are paying for those resources, you should rightfully expect to be getting your money’s worth.

Demo Content Import (one click demo importer)

Demo Content Import (mannual)

We highly recommend against using this method in production. Please only use on an extra copy for testing or experimenting. This method most likely will fail on shared web hosts. Uncheck "import attachments" option if it fails and try again.

1. Install and activate all required plugins
2. Go to Tools > Import > WordPress, install WordPress Importer and run it
3. Select xml file from wpmain file and click Import Demo Data
4. Please be patience as it will take quite some time. Do not interrupt it.
5. Once it's done, go to Appearance > Menus > Manage Locations. Select "Main Menu" next to "Main Navigation".
6. Go to Edit Menus on the same page, select "Main Menu (Main Navigation)" from menus to edit and click Select
7. Setup your homepage to "Main Homepage" in Settings > Reading > Your homepage displays and select A static page
8. All Done.

In some cases you would like to remove demo content. You can remove all posts, pages, etc using WordPress Reset plugin. Be aware that this plugin resets the WordPress database back to it's defaults. Deletes all customizations and content. It does not modify files only resets the database.

Creating home page is a simple process.

1. Pages -> Add New
2. Insert Title
3. Page Options - make changes as you wish
4. Change Page Template to "Blog Page"
   
   
5. Click the "Publish" button

After you create homepage:

1. Settings -> Reading -> Front page displays
2. Choose a "Static Page"
3. set newly created "Home" page.
4. Click "Save Changes" button

1. Install Contact Form 7 plugin ( https://wordpress.org/plugins/contact-form-7/ )
2. Edit contact form and insert there next code:
   <div class="fn__contact"> <div class="item half_item">[text* your-name autocomplete:name placeholder "Your Name *"]</div> <div class="item half_item">[email* your-email autocomplete:email placeholder "Your Email *"]</div> <div class="item half_item">[tel tel-330 placeholder "Phone (optional)"]</div> <div class="item half_item">[text your-subject placeholder "Topic (optional)"]</div> <div class="item">[textarea your-message placeholder "Message"]</div> <div class="item"><div class="xoxo_submit">[submit "Send Message"]</div></div> </div>

Set Blog Page

1. Pages > Add New
2. Insert Title
3. (Required) Choose "Blog Page" from Template inside "Page Attributes" box.
4. Page Options - Change these options as you wish
5. Advanced Options - Change these options as you wish
6. Add Featured Image (optional)
7. Click the "Publish" button

Adding Posts

Adding a new post is the same way as default WordPress installations, however, there are extra options that might need explaining.

Featured Image

While the theme can function without featured images, it's highly recommended that you add a featured image to each post. This not only makes your site/blog more lively but also improves user experience.

To set the featured image, use the WordPress normal method.

Recommended Image Size (for Blog Posts)

Image size (dimensions) will depend on what type of layout you're using throughout your WordPress installation or per individual post basis. This image will not only be used on the post, but also on the category listing pages.

• Compatible with all layouts and default slider: 1920 x auto (width x height)

Supported Post Formats

Audio Format

Setup your post normally and set a featured image. Copy the embed code of the audio from SoundCloud or any other site that gives you audio embed codes. Paste the code in the "Embeded Code" box in the Audio Options. See below screenshot

Gallery Format

1. Click "Add Image" button
2. Choose Images
3. Click "Select" button

See below screenshot

Image Format

Image format works very similar to a standard post. Just set a featured image and you're done.

Link Format

Setup your post normally and set a featured image. Insert your link in the "Link URL" box in the Link Options. See below screenshot

Quote Format

Setup your post normally and set a featured image. Insert your quote content in the "Quote Content" box and insert your quote author in the "Quote Author" box in the Quote Options. See below screenshot

Standard Format

Just set a featured image and you're done.

Satus Format

Setup your post normally and set a featured image. Insert your status in the "Enter Status" box in the Status Options. See below screenshot

Video Format

Setup your post normally and set a featured image. Copy the embed code of the video from YouTube, Vimeo or any other site that gives you video embed codes. Paste the code in the "Embeded Code" box.

Note:  Videos will be resized to fit the container so you can choose a larger embed format if the video site allows you to specify size/dimensions.

See below screenshot

The theme uses Gravatar to display users avatars . to craete or change your Gravatar :

If you have never setup a Gravatar account:

1. Register / login to Gravatar. Upon registering, use the same email address that is associated with your WordPress User Profile.
2. Upload your photo and associate it with that specific email address.

If you already registered at gravatar.com, follow these steps:

1. Click on "My Gravatars" .
2. click on "Add a New Email" .
3. Then, you'll need to click on "Add a New Image" .
4. Upload an image .
5. Then select the email address, and then select your image from bottom. Now it's associated with that email address. Click Save .
6. It will take about 5-10 minutes to propagate on the internet, and then will appear on site.

If you have imported demo content follow (a). Otherwise, follow (b) to create a new menu.

(a) Existing Menu

1. Go to to Appearance > Menus.
2. In the "Manage Locations" area, under Main Navigation, select Main Menu. Click Save.

(b) Creating a New Menu

1. Go to to Appearance > Menus.
2. Click on the + button or the create a new menu link. Enter a menu name and click Create Menu.
3. Using the Custom Links and Pages boxes at the left, add items to the menu and drag/drop to arrange them.
4. (optional) If you would like to use this menu in navigation, in the "Manage Locations" area, under Main Navigation, select your newly created menu. Click Save.
5. Click Save Menu and that is all.

Mobile Menu either setup in above way. You just need to choose proper location.  There are two locations "Main Menu" and "Mobile Menu". That's it.

Sidebars can be left or right side of the page. You can choose its location while creatin

Widgets

You can use any shortcodes in widgets. Just use text widget and put shortcode into it. Besides theme custom widget which may helpful for you. Listed below:

1. Frenify Author
2. Frenify Custom Categories
3. Frenify Followers
4. Frenify Social
5. Frenify Top Articles

Subscribe Form

You can enable/disable Subscribe form through Dashboard -> Xoxo -> Theme Options -> Footer -> Subscribe Switcher

For that install mailchimp ( free wordpress plugin: https://wordpress.org/plugins/mailchimp-for-wp/) plugin and set up it. After activating a mailchimp plugin go to Dashboard -> MC4WP -> Form and insert below code to Form code textarea

After that insert generated shortcode into Dashboard -> Xoxo -> Theme Options -> Footer -> Subscribe Form Shortcode

Totop Button

You can enable/disable Totop button through Dashboard -> Xoxo -> Theme Options -> Footer -> Totop Switcher

Footer Copyright

You can change footer copyright text through textarea in Dashboard -> Xoxo -> Theme Options -> Footer -> Footer Copyright

Theme comes with .po file included under the languages folder. To translate:

1. Download and install Poedit.
2. Open xoxo.po file located here \wp-content\themes\xoxo\languages\ using poedit tool and translate the existing text to your own
3. Save the file with the locale (for example: ru_RU.po). If you have already setup WordPress in your language, you can get it from your wp-config.php file under, for example: define('WPLANG', 'ru_RU');. In this case, you would save your file as ru_RU.po.
4. Step above should have generated a .po and a .mo file. Copy both these files and put them into the languages folder of the theme.

Your Language & Localization

After translating, you may wish to use the correct locale to translate and localize your WordPress installation completely. Refer to Installing WordPress In Your Language at WordPress Codex to learn how to.