The Landscaper - Lawn & Landscaping WP Theme

Contents

1. Change the featured page widget image and text

2. How-to: Update the theme

3. Enable lightbox navigation arrows

4. Import the Essential Grid file

5. Remove double lightbox window

6. Translating the theme

7. How-to: Transfer Theme to Live Server

8. Configure the theme on HTTPS (SSL certificate)

9. How-to: Create Google Maps API key

10. Allowed memory size of # bytes exhausted

11. Create a gallery grid with Essential Grid

12. Adding social icons to the bottom footer

13. Change fonts of The Landscaper

14. How to use the call to action widget

15. My contact form is not working

16. Theme demo images

17. Homepage slider is not visible

1. Change the featured page widget image and text

1. Click on Pages in the menu
2. Edit the page that you want to display with the Featured Page widget
3. On this page add the 'Featured Image' and change the 'Excerpt'
4. Now save this page


The Landscaper excerpt text

2. How-to: Update the theme

Please download the latest installable theme version from your account download page on ThemeForest. Click the "Download" button and select "Installable WordPress files only" for the submenu.


* It's recommended to create a backup of your website before updating the theme. Please install a backup plugin like UpdraftPlus


The theme can be updated on two different ways:

1. Envato Market Plugin

    - Download and install the Envato Market plugin
    - Follow the steps in this article to setup the plugin (one time setup)


2. FTP Client

    - Login to your server with a FTP client
    - Navigate to the theme folder in your WordPress installation (e.g. wordpress/wp-content/themes/)
    - Rename the folder of the theme you're currently using (e.g. theme-name-1 or theme-name-2)
    - Unzip the downloaded zip file and upload the folder to the themes folder on your server
    - Investigate if everything is working correctly
    - Remove the old theme folder from your server

3. WordPress Dashboard

    - Please navigate to Appearance > Themes
    - Activate the default WordPress theme (like TwentySeventeen)
    - Click on the thumbnail of the theme you want to update and click 'delete' in the bottom right corner
    - Click on 'Add New' in the top
    - Click on 'Upload File'
    - Upload the freshly downloaded theme zip file
    - Activate the theme


3. Enable lightbox navigation arrows

To enable the navigation arrows for images inside the lightbox window please follow these steps:

-  Go to Settings -> Media
-  Make sure you enable images for Fancybox (first setting)
-  Scroll a bit down to the 'Gallery' section
-  Switch 'Autogallery' to 'All in one Gallery'
-  Check the box 'Show the gallery navigation arrows'
-  Save the settings

4. Import the Essential Grid file

The "essential-grid" file is located inside in installable theme folder the-landscaper/demo-files/essential-grid.json

Importing the File

1. Please navigate to Ess. Grid -> Import/Export
2. Click on the 'Import' panel
3. Upload the essential-grid.json file
4. Click the small 'Read File' button
5. Click 'Import Selected Data' button (please do not click the full demo data button)


Step 1 to 4:

Importing Essential Grid


Please make sure you click the "Read File" button and not the full demo data button to import the essential-grid file successfully.


Step 5:

Importing Essential Grid


The essential-grid file has been uploaded successfully. If the grid is not showing up on your website please follow the steps in this article.

5. Remove double lightbox window

Please navigate to Ess. Grid -> Global Settings, set the "Select Lightbox Type" option to "Disable Lightbox" and save the settings.


6. Translating the theme

The theme included a translatable .pot file. You can translate the theme in two ways:

1. Translate the .POT language file

You can translate the theme by editing the included .pot language file with a program like PoEdit. After setting up the language you can translate each text string to your own language.

After translating please export a .po and .mo file which you need to upload in the language folder of the theme (theme-folder/language/). 

For more information please see this link


2. Translate with the Loco Translate plugin

With the Loco Translate plugin you can translate the theme inside your WordPress installation.
Please install and activate the Loco Translate plugin, and follow the steps below:

1. Please navigate to Loco Translate -> Themes
2. Click on the correct theme name in the list
3. Click on the 'New Language' link
4. Set your language from the dropdown field
5. Set 'Choose a location' to Custom and press the Start Translating button
5. Type the word you want to translate in the search box and click on it when it appear in the list below
6. Write your translation in the bottom textarea (the translation textarea)
7. Save the settings

You can read this tutorial for more information how to set-up a new translation (screenshots included)

7. How-to: Transfer Theme to Live Server

Please install the Duplicator plugin when you're moving the theme to a live server. 

The plugin will generate a zip file of the entire WordPress installation (WordPress, theme, plugins, settings etc.) and installer file. Both files need to be uploaded to the new location on your server.

You can run the install procedure via http://yourdomain.com/installer.php. Please make sure before you're going through the installer you have created a new MySQL user and database. These details need to be entered half way through the install procedure.

When the installer is completed you will see the login link on your screen and the theme is up and running.

8. Configure the theme on HTTPS (SSL certificate)

To use the theme on HTTPS instead of HTTP a SSL certificate need to be installed on your server. The best is to get in touch with your hosting company if you're not familiar with this.

After the SSL certificate is running on your server there are a few steps to take to make WordPress and the theme work correctly.

The first things is to change the Home URL and Site URL under Settings -> General. Please make sure before changing this your website is accessible through HTTPS, if this is not the case your website will not be working anymore and these settings need to be restored through ftp.

Please install and activate the Really Simple SSL plugin and active the SSL option via Settings -> SSL

The last step is to take a look at the front-end of your website and check if all images are loading correctly. If the logo doesn't display please remove it from the customizer option and add it back to save the image with the correct path.

9. How-to: Create Google Maps API key

IMPORTANT: UPDATE GOOGLE MAPS API KEY

On July 16, 2018 the Google Maps API will change. You need to enter your credit card details to use the API key for Google Maps. Google provide a $200 free usage a month (≈ 28.500 map connections) and if you use more they will start billing you. Unfortunately these changes are made by Google and this is out of our control. Here you can read more about this change.

If you want to keep using Google Maps on your website, but you don't want to enter your credit card details please remove the "QT: Google Maps" widget from the page builder and remove your API key.

Then follow these steps and add the copied HTML code in a "Custom HTML" widget to the page builder. This is the most basic way of adding a Google Map to your website and will be free for usage.





The Google Maps widget requires a Google Maps API key to work. Please follow the steps below to create one:


1.  Please create your Maps API key via this link. And click the Continue button (this could take a minute).


2. Enter a name for your key, click "HTTP Referrers", add the URL of your website and click the 'Create' button 

Please use the examples below to add your website. Replace yourdomain.com with your domain name. Each in a new input field.

*.yourdomain.com/*
http://yourdomain.com/*
www.yourdomain.com/*
yourdomain.com/*


3. Copy the API key you see in the modal.


4. Navigate to the API Manager and click the 'Google Maps JavaScript API' link (see above image). 


5. Make sure you click the 'Enable' button. If you only see 'Disable' you can leave the page

If you're using the Physio theme please also enable the API for Geolocation and Geocoding. If these API's are not enabled the Google Map widget won't work.




Using your Google Maps API key

The Landscaper WordPress theme
Please navigate to Appearance > Customize > Theme Options > Custom and add the key in the Google Map API key input field.

Physio WordPress theme
Within the SiteOrigin Google Map widget you can add your Google Maps API key within the first input field 'API key'.

10. Allowed memory size of # bytes exhausted

Do you see an 'allowed memory size exhausted' error? This is one of the most common WordPress errors, and can easily be fixed by increasing the PHP memory limit in WordPress.

Please follow these steps to increase the PHP memory. If you're not familiar with this please ask your hosting provider to increase the PHP memory

11. Create a gallery grid with Essential Grid

Navigate to the "Gallery" tab in the admin menu and add some posts. Make sure that each post have a Featured Image and at least one "Gallery Category"

Then navigate to Ess. Grid -> Settings (button of the specific grid)

Click to enlarge

Then follow these steps:

1. Click the Source tab
2. Set "Post Types" to Gallery
3. Select the categories you would like to show
4. Save the grid

The posts are now added to the grid. You can display the grid on your website with the "Essential Grid" widget in the page builder.

12. Adding social icons to the bottom footer

The social media icons in the footer (like the theme demo) can be added with some HTML. To add an the icon please navigate to Appearance > Customize > Theme Options > Footer and choose one of the following to add in the 'middle footer text' input field

To add a normal icon:

<i class="fa fa-facebook"></i>

To add a linkable icon:

<a href="http://yourlink.com"><i class="fa fa-facebook"></i></a>

The 'fa-facebook' can be changed to another social media name to display the icon. All available icons can be found here

13. Change fonts of The Landscaper

In the theme customizer you can change the fonts of the theme. The options can be found via Appearance > Customize > Theme Options > Typography


If you want to target elements specifically or need more advanced typographic controls please install the Easy Google Fonts plugin.

The plugin will add a Typography panel to the root of the customizer (Appearance > Customize). Here you can change the font for headings and content of the theme.

To change the font for specific elements in the theme you need to setup 'custom font controls'. To do this please follow the steps below:

1. Navigate to Settings -> Google Fonts 
2. Create a font control. For each font control please enter a reference name, CSS class and click the 'force style' overwrite checkbox. Below you can find the CSS classes for custom elements:


    Navigation
    - Enter the name 'Navigation'
    - Add CSS class .main-navigation li a


    Call to action title
    - Enter the name 'Call to action title'
    - Add CSS class .cta-banner.cta-block .cta-banner-text .cta-banner-title


    Testimonial author title
    - Enter the name 'Tesimonial author'
    - Add CSS class .testimonials .testimonial-person .testimonial-author


3. Please navigate to Appearance > Customize > Typograpghy. You will see 2 panels. In the 'Default Typography' panel you can change the content headings and fonts. In the 'Theme Typography' you will find your custom font controls.

14. How to use the call to action widget

Add call to action heading and buttons
1. Edit the Call to Action Banner
2. Fill in the call to action title
3. Add buttons with the [button href="#"]Text[/button] shortcode and click the blue 'Done' button in the modal

Full width background image
4. Hover the wrench icon of the row (not the widget)
5. Click 'Edit Row'
6.Click the 'Design' panel
7. Add your background image
8. Set background image display to 'Cover'
9. Click the 'Layout' panel'
10. Set 'Row Layout' to 'Full width stretched'
11. Save the page

Click to enlarge the image

15. My contact form is not working

If your contact form don't send or you don't receive messages in your inbox, please check the following things:

1.  Please navigate to Contact -> Edit your form -> Mail
2.  Enter your email address in the "To" and "From" fields (please use the symbols < > in the "From" field)


If you added your email address correctly, like in the above example, but the from still don't send it's most likely that the mail server of your domain is not responding. This can be fixed by installing the WP Mail SMTP plugin.

After installing please navigate to Settings -> Email and enter the following settings on that page:

- SMTP Host
- SMTP Port
- Email address username
- Email address password

You can find the SMTP host and port details in the email you received from your hosting provider.

If you still experience issues please open a support ticket and we're happy to help you.

16. Theme demo images

Due copyrights of the images used in our theme demo we can't distribute them with the theme. Below you find the list of all the images used in the theme, you can buy them from Adobe Stock.

https://stock.adobe.com/stock-photo/hedge-trimmer-works/85133347
https://stock.adobe.com/stock-photo/single-armchair-with-a-red-pedestal-table/84734139
https://stock.adobe.com/stock-photo/gardening-tools-and-seedling-on-garden-table/83937973
https://stock.adobe.com/stock-photo/lawn-mower/83928187
https://stock.adobe.com/stock-photo/manual-weed-conrol/82775115
https://stock.adobe.com/stock-photo/horticulturist-checking-his-appletrees-on-his-farm/80839700
https://stock.adobe.com/stock-photo/backyard-cozy-patio-area-with-wicker-furniture-set/78418523
https://stock.adobe.com/stock-photo/backyard-cozy-patio-area-with-wicker-furniture-set/77662770
https://stock.adobe.com/stock-photo/backyard-cozy-patio-area-with-wicker-furniture-set/77662727
https://stock.adobe.com/stock-photo/snowplow-is-cleaning-a-road/76894223
https://stock.adobe.com/stock-photo/rollrasen/76507139
https://stock.adobe.com/stock-photo/villa/73791722
https://stock.adobe.com/stock-photo/worker-with-a-leaf-blower/73453473
https://stock.adobe.com/stock-photo/walkout-patio-with-concrete-tile-floor-and-landscape-design/70872429
https://stock.adobe.com/stock-photo/nobler-garten-einer-wohnung/72107249
https://stock.adobe.com/stock-photo/cascade-waterfall-in-japanese-garden-in-bonn/70530798
https://stock.adobe.com/stock-photo/hedge-trimming/70569449
https://stock.adobe.com/stock-photo/gardener-pruning-a-tree/70492704
https://stock.adobe.com/stock-photo/gartner-bei-unkrautjaten/68575931
https://stock.adobe.com/stock-photo/fruhlingshafter-garten/67692811
https://stock.adobe.com/stock-photo/nice-water-lily-flower/66966906
https://stock.adobe.com/stock-photo/pacific-northwest-living/66631121
https://stock.adobe.com/stock-photo/pavior/64740698
https://stock.adobe.com/stock-photo/jardin-et-fleur-sauvage/66018283
https://stock.adobe.com/stock-photo/happy-man-shearing-shrub/64667777
https://stock.adobe.com/stock-photo/female-nursery-owner-with-pot-of-flowers/64278557
https://stock.adobe.com/stock-photo/gardener-with-boxwood-posing-at-nursery-or-garden-center/63115925
https://stock.adobe.com/stock-photo/garden-cafe-terrace-with-wicker-chairs-greece/60887406
https://stock.adobe.com/stock-photo/smiling-blonde-woman-phoning-in-a-green-house/57183398
https://stock.adobe.com/stock-photo/portrait-of-man-gardening/55315588
https://stock.adobe.com/stock-photo/summer-restaurant-terrace/54999963
https://stock.adobe.com/stock-photo/kleiner-stadt-garten/54635690
https://stock.adobe.com/stock-photo/gardener-pruning-an-hedge/52918446
https://stock.adobe.com/stock-photo/pose-de-paves-sur-lit-de-sable/51479301
https://stock.adobe.com/stock-photo/employee-watering-plants-with-hose/47141544
https://stock.adobe.com/stock-photo/mother-and-two-children-running-through-garden-sprinkler/43936323
https://stock.adobe.com/stock-photo/rasenroboter-im-garten/41348799
https://stock.adobe.com/stock-photo/elaguer/41347385
https://stock.adobe.com/stock-photo/%E3%82%AC%E3%83%BC%E3%83%87%E3%83%8B%E3%83%B3%E3%82%B0/39781403
https://stock.adobe.com/stock-photo/outdoor/35604235
https://stock.adobe.com/stock-photo/snow-blower/28570632
https://stock.adobe.com/stock-photo/clearing-autumn-leaves-from-gutter-with-trowel/26960918
https://stock.adobe.com/stock-photo/garten/24135660
https://stock.adobe.com/stock-photo/springbrunnen/22730587
https://stock.adobe.com/stock-photo/gartenarbeit-mann-schneidet-hecke/21387921
https://stock.adobe.com/stock-photo/sprinkler-of-water-with-drops/12887868

17. Homepage slider is not visible

If the slider on the homepage is not visible please check the following points:

- Advanced Custom Fields PRO plugin is installed and activated under the Plugin tab.
- The 'Frontpage Fullwidth Slider' (or Jumbotron for Physio) is selected as page template

If all points correctly set but the slider is still not visible please navigate to the theme folder on your server:

wordpress-folder/wp-content/themes/theme-folder/

Please check inside the theme folder if there is duplicated theme folder and delete it.