Overview of the theme, its contents, and how to get started with the theme
Thank you for purchasing our theme! If you have a question that this documentation doesn't answer, ask us on our support forums. If you like the theme, please rate it on ThemeForest.
- Pixelwars Team
Sign in to our support forums to ask your question. To open a new topic, you need your Item Purchase Code (where is my purchase code?).
If you like the theme, you can rate it on your ThemeForest Downloads page.
We assume you have basic knowledge of WordPress. In this documentation, you will learn how to install, set up and customize Empathy.
We've assembled some links to get you started:
Learn WordPress: Level up your WordPress skills.
- (Course) Beginner WordPress User
- (Video) How to Find Help with WordPress
- (Video) WordPress Dashboard Overview
- (Video) How to Install a Theme
- (Video) How to Choose and Install Plugins
- (Video) Using the Theme Customizer
- (Video) Using the Media Library
- (Video) Intro to Publishing with the Block Editor
- (Video) Intro to the Block Directory
- (Video) Using WordPress in Other Languages
WordPress Documentation: A variety of resources to help you get the most out of WordPress.
- Where to Start: Learn the basics of WordPress and take your first steps.
- Dashboard: Get to know the control center of your site.
- Administration Screens
- WordPress Block Editor - Blocks
- Pages Screen - Create Pages
- Posts Screen - Posts Categories Screen - Posts Tags Screen
- Comments Screen - Comments in WordPress - Comment Moderation - Avatars
- Media Library Screen - Media Add New Screen - Edit Media
- Settings General Screen
- Settings Writing Screen
- Settings Discussion Screen
- Settings Media Screen
- Settings Permalinks Screen
- Customization: Get the look and feel you want on your site.
- Maintenance: Keep your site updated, backed up, and ready.
WordPress Support Forums: Community-based Support Forums are a great place to learn, share, and troubleshoot.
- Fixing WordPress Forum: For any problems encountered after setting up WordPress.
- Requests and Feedback Forum: Suggest new features and share feedback about WordPress.
- Everything else WordPress Forum: For relevant questions and problems not covered in the other forums.
Note: The WordPress.org forums don't provide support for commercial themes. For questions about Empathy, please use our support forums.
Free Plugins: The WordPress Plugin Directory is the largest directory of free and open source WordPress plugins. Extend your WordPress experience with plugins.
You can add the theme to your WordPress site in one of the following ways.
The Envato Market plugin connects your site to your ThemeForest account and installs the themes you purchased.
The plugin also helps you keep the theme up to date (see the Update section).
Note: The "Theme/1 - Parent Theme" folder also has a "Previous Version" folder, with the ZIP file of the previous theme version. Don't install it on a new site. It is there for sites that already use the theme: if your site has a problem after an update, you can go back to the previous version by installing this file (see the Update section).
Note: Your host limits the size of the files you can upload. You can see this limit under Tools > Site Health > Info > Media Handling ("Max size of an uploaded file"). If the theme's ZIP file is larger than this limit, install the theme with one of the ways below, or ask your hosting provider to increase the limit.
A child theme inherits the functionality and styling of the parent theme. If you want to change the theme's code, use the child theme: your changes are kept when you update the parent theme (see the Update section).
This theme is coded to high standards to ensure seamless compatibility with plugins.
The theme's features, like the pages of your homepage, the contact form and the shortcodes, are built into the theme. Go to Appearance > Install Theme Plugins to install the recommended plugins:
Loco Translate is a free plugin that you can install from Plugins > Add Plugin when you need it (see the Translation section).
Importing demo data (posts, pages, theme settings, etc.) is the quickest and easiest way to set up your new theme. It allows you to simply edit everything instead of creating content and layouts from scratch.
Before you import the demo, make sure your server meets our system requirements (WordPress and PHP versions, and PHP limits such as memory and upload size). You can check your current values under Tools > Site Health > Info > Server. If you are not sure whether your server meets them, contact your hosting provider.
First, go to Appearance > Install Theme Plugins, and install and activate the plugins listed there. Then choose one of the following methods. A low upload size limit on your server can stop the import. In this case, you need to increase it; see this article for how to do it.
Use this method if the one-click import doesn't work on your server. The files are in the "Sample Data" folder of the theme package. If the theme has more than one demo, each demo has its own folder.
After the import, your site looks like the demo. Replace the demo's details with your own:
Permalinks are the permanent URLs to your individual pages and blog posts, as well as your category and tag archives. A permalink is the web address used to link to your content.
For more information
The settings of this theme are in two places: the logo, the layout and the blog settings are in Theme Options, and the fonts, the colors and the page animations are in the Customizer.
Go to Appearance > Customize. While you change the settings, you can see the changes live on your website. Each setting of the theme has a short description.
To add small style changes, use Appearance > Customize > Additional CSS. For changes in the theme's code, use the child theme, so that your changes are kept when you update the theme (see the Installation and Update sections).
Note: Before version 1.4.9, the theme had its own "Custom CSS" box in the Customizer. When you update the theme, the CSS you saved there is moved to Additional CSS automatically, and it keeps working.
For more information
Pages are similar to posts in that they have a title, body text, and associated metadata, but they are different in that they are not part of the chronological blog stream, kind of like permanent posts. Pages are not categorized or tagged, but can have a hierarchy. You can nest pages under other pages by making one the "Parent" of the other, creating a group of pages.
You can assign a custom template to any page by editing it in the WordPress admin area. To select a custom page template, open the Template dropdown in the settings sidebar.
The theme's page templates:
Write the content of your pages with blocks, and with the theme's shortcodes (see the Shortcodes section). On your homepage, a page shows its title, its content and its featured image; its template is used when the page is opened on its own.
Managing pages is very similar to managing posts, and the screens can be customized in the same way. You can also perform the same types of actions, including narrowing the list by using the filters, acting on a page using the action links that appear when you hover over a row, or using the Bulk actions menu to edit the metadata for multiple pages at once.
Learn more about Managing Pages.
Useful Resources
Learn how to get the most out of the WordPress block editor when publishing your content.
WordPress allows you to choose what your homepage displays. You can use a classic blog page showing your latest posts, or you can assign a static page. If you don't want a blog page on your site, you can set a static homepage only. Creating a blog page is optional. To set a static homepage, simply create (or choose) a page and assign it as the Homepage in Settings > Reading.
Note: Like the demo site, your homepage should be a page with the theme's "Empathy Homepage" template. It shows your pages one at a time, with its own menu. If you import the demo with the one-click import, its "Home" page is set up as your homepage (see the Demo Import section).
Then select this page as your homepage (see below) and add your pages to it (see the Template Pages section). Use only one page with the "Empathy Homepage" template.
The homepage shows the pages you add to the "Empathy Template Pages" widget area, not the content of this page. Like on the demo, you can also select this page in the "(Empathy) [PAGE] Home" widget: then its content and its featured image are the first page of your homepage.
Your homepage shows several of your pages, one at a time, like "home", "about me", "resume", "portfolio", "blog" and "contact" on the demo site. The page with the "Empathy Homepage" template shows them (see the Homepage section).
"Title" is the text of the menu item. If you leave it empty, the menu item shows the title of the page. "Icon" is the name of an icon, like pe-7s-user, shown in the menu and before the title of the page (see Icons in the Shortcodes section).
Note: Add only the theme's "[PAGE]" widgets to this widget area, and show each page only once.
Tip: The demo content has these pages and widgets. Import it and edit them (see the Demo Import section).
The "contact" page of the demo shows social icons, contact details, a contact form and a map. Its content is made with the theme's shortcodes, each in a "Shortcode" block, and it is shown with an "(Empathy) [PAGE] Custom" widget. The form and the map look like this:
[section_title text="Drop Me A Line"] [contact_form to="yourname@example.com" subject="Contact form message"] [map latitude="-25.363882" longitude="131.044922" zoom="5" image=""]
Note: The form sends the messages through WordPress, with your site name as the sender. If the messages don't arrive, install an SMTP plugin, like WP Mail SMTP, or ask your hosting provider whether your server can send email.
Go to Appearance > Customize:
Go to Appearance > Theme Options > Layout:
Here, you will find the information you need to create a blog post. Once you have created your blog post, you can publish it on your blog page. Blog posts have a title, body text, and associated metadata, and they are part of the chronological blog stream. Posts are categorized and tagged, but can not have a hierarchy. Post categories can have a hierarchy. You can nest categories under other categories by making one the "Parent" of the other, creating a group of categories.
If you have any questions about blog page and blog posts, feel free to reach out to us on our support forum. We are happy to assist you!
Let your creativity flow and craft engaging blog posts to share. This will enhance the value of your website and also help it rank higher in search engines.
The theme adds a "Title Visibility" box to posts: check "Hide title" to hide the title of a post. Portfolio items have a "Type" box (see the Portfolio section).
Creating a blog page in WordPress is simple, and you can do it in just a few steps. Here's how (see also the Homepage section):
Now, whenever you publish a new blog post, it will automatically appear on your blog page. Happy blogging!
To show your latest posts on your homepage too, add an "(Empathy) [PAGE] Blog" widget to it (see Page Widgets).
You can use categories to define sections of your site and group related posts. The default category is "Uncategorized" until you change it in the WordPress Writing settings.
The Post Formats feature in WordPress allows you to use different styles and layouts for various types of content. This feature helps your theme make posts more dynamic and user-friendly.
On the post edit screen, you can choose the format of a blog post. To do this, open the edit screen of a post and locate the "Format" option in the settings sidebar on the right-hand side.
Note: You can change the post format of an already published post at any time. Simply edit the post and select a different "Format" from the options. WordPress will automatically adjust the layout based on the new format, ensuring that your content remains visually appealing.
WordPress provides a variety of Post Formats, each designed for specific types of content. When creating a post, you can enhance its layout using the WordPress Block Editor.
In the block inserter menu, you will find suitable blocks for each post format. For example, the "Gallery" format supports the "Gallery" block, and the "Video" format supports the "Video" block. To quickly find the right block for a format, simply type the format name (e.g., "Image," "Quote," or "Video") into the block search field. WordPress will automatically suggest the most relevant block for your post format.
This theme supports the following WordPress Post Formats:
JOHN: Hey there MARY: Aye, matey! JOHN: Huh?
Hovering over a row in the posts list will display action links that allow you to manage your post. You can perform the following actions:
Learn more about Managing Posts, Categories and Tags.
Useful Resources
Learn how to get the most out of the WordPress block editor when publishing your content.
The portfolio comes with the Pixelwars Portfolio plugin. Go to Appearance > Install Theme Plugins, then install and activate "Pixelwars Portfolio". Now you can see the "Portfolio" menu in your dashboard.
Portfolio items are edited in the classic editor. Its toolbar also has the theme's "Insert Shortcode" button (see the Shortcodes section).
The "Type" box decides what happens when a visitor clicks the item on your portfolio page:
Your portfolio items are shown on your homepage, on the page of an "(Empathy) [PAGE] Portfolio" widget (see the Template Pages section):
The portfolio page shows all your portfolio items, with an "All" filter and a filter for each category at the top. When a visitor opens the page on its own, for example from your menu, they are sent to it on your homepage.
The shortcodes are built into the theme, so you don't need a plugin for them. The pages of the demo, like "about me", "resume" and "contact", are built with them (see the Template Pages section).
Some shortcodes work together: a wrapper shortcode (like row or tabs_wrap) holds item shortcodes (like column or tab_pane), and in a group of icons, toggles or accordions, the first and the last item open and close the group (like first_icon="yes" and last_icon="yes"). Keep them together as in the examples below.
[row] [column width="8"]Content here.[/column] [column width="4"]Content here.[/column] [/row] width="" ... 1-12. The widths of the columns in a row add up to 12, like 6 + 6 or 4 + 4 + 4. width_xs="" ... (optional) 1-12. The width on phones (screens narrower than 768 px). Without it, the columns are shown one below the other there. width_md="" ... (optional) 1-12. The width on screens 992 px and wider. width_lg="" ... (optional) 1-12. The width on screens 1200 px and wider.
[section_title text="Services"] text="" ... The title.
[event] <h2>WORK HISTORY</h2> [icon name="pe-7s-ribbon"] [/event] [event] <h3>Dec 2013 - Current</h3> <h4>Front End Web Developer</h4> <h5>Pixelwars Inc.</h5> Description. [/event]
A timeline for your work experience and education, like on the "resume" page of the demo. The first event is the title of the group: a Heading 2 with an icon. Each next event has the date as a Heading 3, the position as a Heading 4, the company or school as a Heading 5, and a description.
[progress_bar text="Photoshop" percent="90"] text="" ... The name of the skill. percent="" ... 1-100. The length of the bar.
[service] <img src="" alt=""> <h4>COPYWRITER</h4> Description of the service. [/service]
An image, a title as a Heading 4, and a description. On the "about me" page of the demo, each service is in a column of a row.
[testimonial] <img src="" alt=""> <h4>Name</h4> <h5>Job</h5> Text of the testimonial. [/testimonial]
[fun_fact] [icon name="pe-7s-coffee"] <h4>1,250 Cups of Coffee</h4> [/fun_fact] [process] [icon name="pe-7s-light"] <h4>Idea</h4> [/process]
An icon with a short text as a Heading 4, in two styles. The "contact" page of the demo uses fun_fact for the contact details.
[client] <img src="" alt=""> [/client]
The logo of a client.
[tabs_wrap titles="Design,Code" active="Design"] [tab_pane]Content of the first tab.[/tab_pane] [tab_pane]Content of the second tab.[/tab_pane] [/tabs_wrap] titles="" ... The titles of the tabs, separated by commas. active="" ... The title of the tab that is open first.
[accordion first_accordion="yes" active="yes" title="Title"]Content here.[/accordion] [accordion title="Title"]Content here.[/accordion] [accordion last_accordion="yes" title="Title"]Content here.[/accordion] [toggle first_toggle="yes" title="Title"]Content here.[/toggle] [toggle last_toggle="yes" title="Title"]Content here.[/toggle] first_accordion="yes", first_toggle="yes" ... For the first item of the group. last_accordion="yes", last_toggle="yes" ... For the last item of the group. A group of one item has both. active="yes" ... (optional) The item is open when the page loads.
In an accordion, only one item is open at a time. Toggles open and close independently.
[button text="DOWNLOAD CV" url="" new_tab="" size="" icon=""] url="" ... The address the button opens. new_tab="" ... (optional) yes opens the address in a new tab. size="" ... (optional) small, medium or big. icon="" ... (optional) The name of an icon, like pe-7s-download (see Icons below).
[alert type="success"]Text here.[/alert] type="" ... standard, success or error.
[icon name="pe-7s-coffee"] name="" ... The name of an icon (see Icons below).
[quote name="Steve Jobs"]Design is not just what it looks like and feels like. Design is how it works.[/quote] name="" ... The name of the person.
[social_icon first_icon="yes" type="facebook" url="https://www.facebook.com/username"] [social_icon type="instagram" url="https://www.instagram.com/username"] [social_icon last_icon="yes" type="twitter" url="https://x.com/username"] first_icon="yes" ... For the first icon of the group. last_icon="yes" ... For the last icon of the group. A group of one icon has both. url="" ... The address of your profile. For the rss icon, use the feed address of your site, like https://www.yoursite.com/feed/ type="" ... behance, blogger, delicious, digg, dribbble, facebook, fivehundredpx, flickr, forrst, foursquare, friendfeed, github, google-plus, imdb, instagram, lastfm, linkedin, picasa, pinterest, rss, skype, slideshare, snapchat, soundcloud, spotify, stack-overflow, tumblr, twitter (X), vimeo, vine, vkontakte, weibo, wordpress, xing, youtube
[contact_form to="yourname@example.com" subject="Contact form message"] [map latitude="-25.363882" longitude="131.044922" zoom="5" image=""]
See Contact Page for their options, the Google Maps API key and how the messages are sent.
<h4>I am [rotate_words titles="a writer.,a blogger.,an adventurer."]</h4> titles="" ... The words, separated by commas.
Types the words one after another, like on the "home" page of the demo.
[mini_text]Text here.[/mini_text]
Shows a text in a narrower column, for example in a Standard portfolio item (see the Portfolio section).
All texts of the theme are translatable. You can translate them into your language with a plugin (Loco Translate) or with a desktop editor (Poedit).
The theme includes a template file that contains all of its texts: empathy.pot, in the "languages" folder of the theme. You can also use translation to change the theme's English texts. For example, category archives show the title Category. You can create an "English (United States)" translation and change this title to something like Posts in Category.
Important: Don't save your translation files in the theme folder. Theme updates replace the whole theme folder, so your translations would be deleted. Save them in one of the folders described below, which theme updates don't touch.
empathy-de_DE.po and empathy-de_DE.mo for German. Then upload them to the "wp-content/languages/themes/" folder.
Go to Settings > General and choose your language in "Site Language". Your translation appears on the site only when the site language matches it.
The labels of the portfolio in your dashboard, like "Portfolio Categories" and the options of the "Type" box, come from the Pixelwars Portfolio plugin. To translate or change them, follow the same steps under Loco Translate > Plugins > Pixelwars Portfolio.
To publish your content (posts, pages, and menus) in more than one language, use a multilingual plugin. For the theme's own texts, most of these plugins use the theme's translation files, so translate the theme first as described above.
A backup is a copy of your site that you can go back to if something goes wrong, like a failed update, a broken plugin or a hacked site. Keep recent backups, and keep at least one copy outside your server.
A full backup has two parts. You need both to restore your site:
Keep copies outside your server (in cloud storage or on your computer), so you can restore your site even if your server has a problem. See WordPress Backups to learn more.
Restore your site with the same tool you used to back it up. In UpdraftPlus, go to Settings > UpdraftPlus Backups, find the backup in the list of existing backups and click "Restore". For hosting backups, use your hosting control panel or ask your hosting provider.
Note: From time to time, check that your backups work, for example by restoring one on a test site.
Choose one of the following ways. With the Envato Market plugin, you don't need to download anything. For the other two ways, download the new theme package from your ThemeForest account and unzip it. The theme file to upload (empathy.zip) is inside the "Theme/1 - Parent Theme" folder of the package, in the folder with the new version number.
Note: The "Theme/1 - Parent Theme" folder also has a "Previous Version" folder, with the ZIP file of the previous theme version. If your site has a problem after an update, you can go back to the previous version: install this file the same way, via WordPress or via FTP.
The Envato Market plugin connects your site to your ThemeForest account. WordPress can then check for updates of the themes you purchased and install them.
You don't need to activate another theme or delete the current one first. Switching to another theme and back can mix up your menu locations and widgets.
Note: If your host doesn't allow uploading large files, update the theme via FTP.
You can upload files to your site with an FTP client or with the file manager in your hosting control panel. See Updating WordPress using FTP to learn more about both.
Note: Don't upload the new folder over the old one. Files that were removed in the new version would stay on your server.
The theme comes with the Pixelwars Portfolio plugin. A new theme version can include a new version of it, so update it right after you update the theme: go to Appearance > Install Theme Plugins and update it there. WordPress also shows a notice in the dashboard when it needs an update. The other plugins the theme recommends (see the Plugins section) come from WordPress.org, so you can update them like your other plugins, in Dashboard > Updates or on the Plugins page.
Keep WordPress up to date, because new versions include security fixes (see the Security section). Before you update to a new major version of WordPress, make a backup and check whether a theme update for the new version is available. You can find your theme's page on ThemeForest in the Pixelwars portfolio.
If you prefer to start major updates yourself, go to Dashboard > Updates and click "Switch to automatic updates for maintenance and security releases only". Maintenance and security releases will still be installed automatically. Don't postpone major updates for long.
Using a WordPress site securely is essential for protecting your website from potential threats. Here are some key security recommendations:
Always keep WordPress, themes, and plugins updated to the latest versions to prevent security vulnerabilities. See the Update section to learn how to update the theme.
Download the theme and its updates only from your ThemeForest account or through the Envato Market plugin (see the Update section). Download plugins only from WordPress.org or from their developers' websites. Never use "nulled" (pirated) copies of themes or plugins: they often contain hidden malicious code that can give attackers control of your site.
Delete the themes and plugins you don't use. Deactivated themes and plugins still stay on your server, and a security flaw in them can still put your site at risk. Don't delete the parent theme if you use its child theme, and keep one default WordPress theme (like Twenty Twenty-Five) as a fallback.
WordPress runs on PHP, and old PHP versions no longer receive security fixes. You can see your PHP version under Tools > Site Health > Info > Server. If it is no longer a supported version, ask your hosting provider to switch to a newer one. Before switching, update WordPress, your theme, and your plugins.
Don't use "admin" or other easy-to-guess usernames. WordPress doesn't let you change a username, so if your site has an "admin" account, create a new administrator account with a unique username, log in with it, and delete the old account. When WordPress asks what should be done with the content owned by that user, choose "Attribute all content to another user" and select your new account. Otherwise, all posts and pages of the old account will be deleted.
Ensure that you use complex passwords for your admin panel, database, and hosting account. Consider using a password manager. Don't re-use the same password on different services, especially if you are using the same username.
Ensure your website uses HTTPS with an SSL certificate. Most hosting providers offer free SSL via Let's Encrypt. Once your site opens with https://, go to Settings > General and change both "WordPress Address (URL)" and "Site Address (URL)" to start with https://. See HTTPS for WordPress for more details.
Use a security plugin like Wordfence, Kadence Security (formerly iThemes Security), or Sucuri Security to add extra protection layers. Important: If you decide to use a security plugin, make sure to activate only one at a time. Running multiple security plugins simultaneously may cause conflicts and errors.
Prevent brute-force attacks by limiting the number of failed login attempts. Wordfence and Kadence Security include this feature. If you don't use one of them, you can use a plugin like Limit Login Attempts Security (formerly Limit Login Attempts Reloaded).
For additional security, enable 2FA for your WordPress login to prevent unauthorized access. With 2FA, you enter a one-time code from an app on your phone after your password. WordPress doesn't include 2FA by default. Wordfence and Kadence Security include this feature. If you don't use one of them, you can use the Two Factor plugin.
Use a backup plugin like UpdraftPlus or your hosting provider's backup service to prevent data loss (see the Backups section).
By following these security measures, you can significantly reduce the risk of attacks and keep your WordPress site safe.