1. Introduction

Listpress WordPress Theme Documentation

Thank you for choosing the Listpress WordPress theme.

1.1. Requirements

This theme requires WordPress version 5.4.2 or higher. For the best performance and security, we strongly recommend using the latest stable release of WordPress to ensure all known issues and vulnerabilities are addressed. Additional requirements include:

• PHP version 5.6 or higher. For optimal performance, we recommend using PHP version 7.4 or above.
• MySQL version 5.6 or higher, or MariaDB version 10.0 or higher.
• A WordPress memory limit of at least 128 MB.

Server Requirements: https://make.wordpress.org/hosting/handbook/handbook/server-environment

1.2. What's Included

After downloading the Listpress theme, you will receive a complete package that includes the following files:

• Listpress Theme: An installable WordPress theme ZIP file.
• Listpress Child Theme: A child theme ZIP file along with a readme.txt containing details about the child theme.
• Documentation: A link to this user guide.

2. WordPress Installation

Please follow the video instructions below to learn how to install WordPress on your hosting environment:

1. For local host: https://www.youtube.com/watch?v=snFzbPm_RUE
2. For cPanel: https://www.youtube.com/watch?v=t-YBqV2ReR0

3. Upload and Activate Theme

Before installing the theme, you need to upload the theme files and then activate the theme. There are two ways to upload the theme files:

• Using Theme Uploader
• Using FTP Clients

3.1. Using Theme Uploader

Next, install and activate the following pre-packaged plugins:

1. Classified Listing Free: Required. This plugin must be installed.
2. Classified Listing Pro: Required. This plugin must be installed.
3. Classified Listing Store: Optional. Install only if you need store functionality.
4. Classified Listing Toolkits: Required. Install only if you need store functionality.
5. Listpress Core: Required. This plugin must be installed.
6. Elementor Website Builder: Required. This is the page builder plugin.
7. One Click Demo Import: Required if you wish to import demo content. You may deactivate it after the import is complete.
8. WP Fluent Forms: Optional. Install if you want to use contact forms.

Note: All required plugins must be installed and activated for your site to match the demo exactly.

Follow the steps as illustrated in the images below:

3.2. Using FTP Clients

Follow these steps to upload your theme using an FTP client:

1. Open an FTP client (e.g., FileZilla) and connect to your WordPress installation directory.
2. Navigate to the /wp-content/themes/ folder and upload the theme folder.
3. Log in to your WordPress Admin Dashboard and go to the Appearance > Themes section.
4. The Listpress theme will appear in the list of available themes. Click Activate to enable it.

4. Importing Demo Contents

One Click Demo Import:

We use the One Click Demo Import plugin to import demo content. Please follow the steps below to complete the import process:

1. Install and activate the One Click Demo Import plugin. This plugin is already recommended within the theme package. If you haven’t installed it yet, you can download it here: https://wordpress.org/plugins/one-click-demo-import/
2. Go to Appearance > Import Demo Data. You will see all the available demos on this page. Hover over your preferred demo and click the Import Demo button.
3. Next, click the Continue & Import button. The import process will then begin, so please do not close the window until it has been fully completed.

Here are a screenshots for further reference:

5. Set Home and Blog Page

Note: If you have already imported the demo content, you can skip this section because the homepage and blog page are pre-selected in the demo. However, if you wish to change them, please follow the steps below.

To set the default Home and Blog pages, log in to your WordPress Admin Dashboard and navigate to Dashboard > Settings > Reading.

1. Under the Your homepage displays option, select A static page.
2. From the Homepage dropdown, choose the page you want to set as your Home page.
3. From the Posts page dropdown, choose the page you want to display your Blog posts.
4. Click Save Changes to apply the settings.

6. Directory / Listing Setup

We use the Classified Listing Pro plugin to manage directory and listing functionalities, and the Classified Listing Store plugin to handle membership features. For detailed guidance, please refer to the official plugin documentation and tutorials.

Video tutorial:

7. Customize Menu

To customize the menu, navigate to Appearance > Menus and follow these steps:

1. Create two menus: a Primary Menu and a Topbar Menu.
2. Add your desired menu items to each menu.
3. Scroll down to the Menu Settings section and assign the menus accordingly:
   • Select the Primary Menu as the Primary menu.
   • Select the Topbar Menu as the Topbar menu.

7.1 Mega Menu / Multi-Column Menu

1. Collapse a parent menu item and select the Mega Menu option from the Make as Mega Menu dropdown.
2. Create several child menu items under the parent menu, depending on the number of columns you want. For example, to create 4 columns, add 4 child menu items under the parent menu.
3. Add additional menu items under each second-level (child) menu item as needed.

The Mega Menu structure will appear as follows:

• Mega Menu
  • 1. Column 1
    • 1. Menu item
    • 2. Menu item
    • 3. Menu item
  • 2. Column 2
    • 1. Menu item
    • 2. Menu item
    • 3. Menu item
  • 3. Column 3
    • 1. Menu item
    • 2. Menu item
    • 3. Menu item

Here are a screenshots for further reference:

8. Change Site Title and Favicon

To update your site title and favicon, navigate to Dashboard > Appearance > Customize > Site Identity. Then, follow these steps:

1. In the Site Title field, enter your desired site name.
2. In the Tagline field, enter a short description or slogan for your site (optional).
3. To change the favicon (site icon), click Select site icon and upload your preferred image. The recommended size is 512x512 pixels.
4. Click Publish to save your changes.

9. Site Colors Settings

To update the global colors of your site, navigate to Dashboard > Appearance > Customize > Colors. You will find several color groups, such as Site Color, Top Bar Color, Header Colors, and more. Select your desired colors from these options to customize the appearance of your website.

10. Logo Settings

To update the site logo, navigate to Dashboard > Appearance > Customize > Site Identity. We have added additional fields for logo customization:

1. Upload the Main Logo, which should be the darker version of your logo.
2. Optionally, upload a Light Logo and a Mobile Logo for specific use cases.
3. If you prefer to use the same logo across the site, you only need to upload the Main Logo.
4. You can also adjust the logo size manually using the Main Logo Dimension textbox.

11. Typography Settings

To customize the typography of your site, navigate to Dashboard > Appearance > Customize > Typography. You will find typography settings grouped by Body, Headings, and Menu for easier management.

12.1 Site Identity

To update the site logo, navigate to Dashboard > Appearance > Customize > Site Identity. Additional fields are available for logo customization:

• Main Logo
• Light Logo
• Mobile Logo
• Logo Dimensions
• Favicon

12.2 General Settings

To modify General Settings, navigate to Appearance > Customize > General.

• Container Width
• Enable SVG Upload
• Back to Top
• Remove Admin Bar
• Disable Image Srcset
• Preloader
• Full Site Image Blend
• Site Radius
• Button Radius

12.3 Header Settings

To customize the header options, navigate to Appearance > Customize > Header.

• Main Menu Section
• Topbar Section
• Nav Drawer Section

12.4 Banner - Breadcrumb

To customize the breadcrumb settings, navigate to Appearance > Customize > Breadcrumb.

• Banner Image
• Banner Height
• Title
• Breadcrumb

12.5 Typography Settings

To customize the typography of your site, navigate to Dashboard > Appearance > Customize > Typography.

• Body
• Headings
• Menu

12.6 Contact & Social

To update your contact and social details, navigate to Dashboard > Appearance > Customize > Contact & Social.

• Phone
• Email
• Website
• Address
• About Us content

• Facebook
• Twitter
• LinkedIn
• YouTube
• Pinterest
• Instagram
• Skype
• TikTok

12.7 Site Colors Settings

To update the global colors of your site, navigate to Dashboard > Appearance > Customize > Colors.

• Site Color
• Top Bar Color
• Header Colors
• Banner Color
• Footer Color

12.8 Blog Settings

To configure blog archive settings, navigate to Appearance > Customize > Blog Settings.

• Meta Settings
• Title Above Meta
• Read More
• Multiple Category Colors
• Blog Style
• Grid Columns
• Content Limit
• Pagination
• Masonry
• Choose Meta

12.9 Blog Details Settings

To customize the blog post details page, navigate to Appearance > Customize > Post Details Settings.

• Meta Style
• Banner Title
• Meta, Tags, Share Icon, Author Profile, Caption, Post Navigation Visibility
• Related Posts

To add a new social icon, insert the following code in your child theme’s functions.php file:

add_filter('listpress_social_sharing_icons', function ($social_icon, $url='', $title=''){
	$social_icon['instagram'] = [
		'url'  => "https://www.instagram.com/?{$url}",
		'icon' => 'fab fa-instagram'
	];
	return $social_icon;
});

12.10 Listing Settings

To customize the listing archive page, navigate to Appearance > Customize > Listing Archive.

• Listing Style
• Make Italic
• Enable collapsable sidebar
• Archive container width
• Price Display Format: Price Shorthand. Eg. K, M, B, T, Lac, Cr etc

12.11 Listing Details Settings

To customize the listing details page, navigate to Appearance > Customize > Listing Details.

• Layout
• Listing Gallery Style
• Separate Gallery Video
• Gallery Height
• Enable thumbs gallery
• Slider Columns

12.12 Layout Settings

To configure page layouts, navigate to Appearance > Customize > Layout Settings.

• Page Layout
• Blog Layout
• Single Post Layout
• Error Layout
• Listing Archive Layout
• Listing Single Layout

12.13 Footer Settings

To configure the footer settings, navigate to Appearance > Customize > Footer.

1. Footer Layout
2. Footer Width
3. Sticky Footer
4. Copyright Settings

12.14 Error Page

To customize the Error Page settings, navigate to Dashboard > Appearance > Customize > Error Page.

1. Error Image
2. Error Text
3. Error Button Text

16. Translating Theme

You can translate this theme into another language easily. To ensure your website functions properly, translate the following components:

• Theme: Listpress
• Plugin: Listpress Core
• Plugin: Classified Listing Pro
• Plugin: Classified Listing Store

There are many tools available for translation, but the easiest way is to use the Loco Translate plugin. This plugin allows you to translate any WordPress theme or plugin that supports translation.

Here's a quick video tutorial on how to use Loco Translate:

17. Updating Theme

Occationally we provide updates which includes new features and bugfixes. Updating WordPress theme is standard WordPress functionality.

Before Updating Theme:

You can use this plugin to keep the backup: https://wordpress.org/plugins/wp-theme-plugin-download/

There are few ways to update WordPress theme. You can follow any of the methods described below:

Method 1: Automatic Update by Using Envato Market Plugin

1. Install and activate the "Envato Market" plugin manually. Here's the plugin zip file: https://www.envato.com/lp/market-plugin/
2. From WordPress Admin Panel, navigate to "Envato Market" menu.
3. In this page, you'll find a field for insering Envato Token. Insert your Envato Token Code from there. You can generate this code from this link: https://build.envato.com/create-token/?purchase:download=t&purchase:verify=t&purchase:list=t.
   Remember, while generating the token, you have to login using the same envato id which you used to purchase theme.
4. After completed the above steps successfully, Navigate to Appearance -> Themes. Here you'll see an "Update now" link beside your theme. Click on that link and your theme will be updated automatically.

Here's a quick video tutorial explaining this method:

Method 2: By Uploading ZIP File

1. From the WordPress Admin Panel, navigate to Appearance > Themes.
2. Click the Add Theme button at the top of the page, then select Upload Theme.
3. Upload the Listpress update ZIP file and install it.
4. Once the installation is complete, you may see the message "Destination folder already exists". Click "Replace installed with uploaded" to update the current theme with the new version.

Method 3: By FTP

1. Using your FTP client, navigate to "/wp-content/themes/" folder on your server and delete the "listpress" folder from there.
2. Now upload the latest non-zipped theme folder into that "/wp-content/themes/" folder .

After Updating Theme:

** After updating the theme please update all plugins which come with the theme.

18. Demo Content installation failed

This is a hosting issue. In most hostings demo installation will work fine. But some hostings block certain permissions which may cause this issue. If this happens to you, you can contact your hosting provider or alternatively send a support request to support@radiustheme.com and we will help you to fix this.

19. 404 Error in all pages

If you face this type of issue, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

20. Contact

If you face any issue please contact us at support@radiustheme.com. We provide 15 hours real-time support for our customers.

Thank you for purchasing our theme.

21 Where is My Purchase Code?

To learn about how to find your purchase code. When you buy a product from envato you get a purchase code. visit the following link: