Santana Theme Documentation

# Introduction

Thank you for purchasing our theme. We are delighted to have you as one of our valued customers, and we are committed to ensuring your satisfaction with our products..

License

If your end product, including the item, will be free to the end user, then a Regular License is what you need. An Extended License is required if the end user must pay to use the end product.

Click here to learn more about what each license is for and which one to purchase.

Note: One license is valid for one domain only. If you want to use the theme on another domain, then you have to purchase another license.

License FAQ

I need to use the theme on a second site, do I need a second license?

Yes. One theme purchase allows you to use it on one finished site. If you need to use it on a second site, you must purchase a second license.

Can I use the theme on a test site and then move it to a live site when finished?

Yes, you can. You can keep the theme on a test site to build it, then move it to the live site once you’re finished.

Can I keep a test and live sites with one Regular License purchase?

You can keep one test/staging website and one live website with one Regular License. Keep in mind that you must use the same domain.

Do I need a new license to use the theme on a WordPress multisite?

Since the multisite websites are located under one domain, it is allowed to use WordPress Multisite under a Regular License.


# Installation

To install this WordPress Theme, you must have a working version of WordPress already installed. If you need help installing WordPress, follow the instructions in WordPress Codex. Below are all the useful links for WordPress information:

Server requirements

To use any of our WordPress themes, we recommend your host supports WordPress 6.3 or greater, PHP 7.4 or greater version (WordPress is now recommending PHP 7.4, read more), and MySQL 5.7 or greater version.

For detailed PHP extension recommendations, see the Hosting Handbook.

We recommend that you contact your web hosting service provider to make sure that your server PHP configuration limits are as follows:

  • max_execution_time 300
  • memory_limit 512M
  • post_max_size 32M
  • upload_max_filesize 32M

If you are running an unmanaged dedicated server or VPS, you should check your php.ini file. Alternatively, you can edit .htaccess file at the root of your website and add the following values:

  • php_value max_execution_time 300
  • php_value memory_limit 512M
  • php_value post_max_size 32M
  • php_value upload_max_filesize 32M

Setting these values will ensure you will not get error messages during the installation.

Theme Installation

Extract the zipped package downloaded to your computer. In the extracted package you will find santanaTheme.zip which is the WordPress theme file.

Installing the theme can be done two ways.

You can upload the theme ZIP file using the built in WordPress theme upload, or copy the files through an FTP client.

1 - Using WordPress Theme Upload:

  • Login to your WordPress admin.
  • Navigate to Appearance > Themes and click on Add New and Upload Theme.
  • Select the zipped theme file, corprate.zip, and click Install Now button.
  • After the successful installation, click on Activate or navigate to Appearance > Themes and click on Activate button to activate the newly installed theme.

2 - Uploading via FTP:

  • Log into your web server with FTP client software.
  • Unzip the santanaTheme.zip file and ONLY use the extracted /santana Theme folder.
  • Upload the extracted corprate theme folder into /wp-content/themes.
  • Navigate to the Appearance > Themes tab and activate the theme.

The required plugins

After installing the theme, you need to install required plugins. You will see a notice for installing required plugins.

Click on Begin installing plugins. Or go Santana Panal > Reqiuer Plugins.

You will see list of plugin need to be installed. Now, Click plugins ThenInstall This Plugins.

All plugin will be installed. Now, Click on Return to Required Plugins Installer.

This Is All Plugin

  • Contact Form 7
  • Classic Editor
  • Classic Widgets
  • One click Demo Import
  • Regenerate Thumbnails
  • Elegent Pots Manager (Not required - A tool developed by us that changes the appearance of Posts Section To New Style)

Import Demo content

Our theme includes a simple One-click demo content installation, which allows your site to look exactly as on the theme demo.

Note: Don't forget to backup All your content before using the demo importer feature.

Go to the admin area Santana Panal > Import Demo Data.

Now, Click on Import Demo button and then on next step click on Continue & Import.


# Custom Menus

Here's how to add menus to your website.

We've added two locations for adding links (navBar and footer).

To add a new navigation Menu, go to WordPress Dashboard > Appearance > Menus.

Custom Menus

  • add menu Name
  • choice where you need to show the menu
  • click 'create Menu' To Add New Menu

this is result

Custom Menus

# Widgtets

As for the tools that you will get in the Santana Theme template, their number is 9 widget.

These tools have full control over the display method, as you have the ability to choose the display method, display by category, the number of displayed posts, and many other options that we will talk about later.

Before you start showing the widget that come with the Santana theme, first you should know how to access these add-ons and how to include them in the theme.

To access the widgets, from wordpress dashboard go to 'Appearance > widgets'.

I advise you to download the Classic Widgets plugin because it has a clean interface that is easy to access and control.

Note: Just to make sure, every widget that you can put in the sidebar you can put in the footer or slider sidebar.

When you reach the Widget panel list, this interface will appear, which we have organized to avoid any confusion while dealing with add-ons and installation locations.

Widget Pnal

You will notice that some elements are highlighted in distinctive colors, the aim of which is to show the most important controls and access them quickly.

  • In the left menu you will notice the add-ons that you can add to your site, they are divided into two sections, widgets that pink Color, and widgety that light blue color.
    • Category - (pink)
    • Contect Info - (pink)
    • Quick About Us - (pink)
    • Social Media - (pink)
    • Widget Zero - (blue)
    • Widget One - (blue)
    • Widget Two - (blue)
    • Widget Three - (blue)
    • Widget Four - Asaid - (blue)
    • Widget Five - Asaid - (blue)
    • Widget Six - (blue)
    • Widget Sveen - (blue)
    • Widget Eight - Asaid - (blue)
    • Widget Nine - (blue)
  • On the right side you will find the places where you can display the elements, which are
    • Run Widget In Home Page (In Top, Or Bottom, Or Side Bar)
    • Run Widget In Content Page (In Top, Or Bottom, Or Side Bar)
    • Run Widget In Search Page (In Top, Or Bottom, Or Side Bar)
    • Run Widget In Category Page (In Top, Or Bottom, Or Side Bar)
    • Run Widget In Footer (This Run For All Page)
    • Side Menu (Here you can add widgets to the animated side menu.)

You can add widgets by dragging and dropping.

Widget Zero Or Hero Widget
Widget zero

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'One' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget zero
  • Count Of Posts: You can control the number of posts that will appear in the widget.
  • Animation: There are 3 animations for displaying posts, automatic animation or animation via button.
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Control image size and resolution
Widget One
Widget zero

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Zero' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget zero
  • Enable Widget Name: You can enable/disable the definition and classification bar above the tool.
  • See More: Name of conversion to Category (possible to change)
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Control image size and resolution
Widget Two
Widget zero

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Two' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget two
  • Enable Widget Name: You can enable/disable the definition and classification bar above the tool.
  • See More: Name of conversion to Category (possible to change)
  • Style:You can choose between two ways for the widgets to appear.
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Control image size and resolution
Widget Three
Widget Three

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Three' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • See More: Just Name
  • Category: You can choose up to 4 category, if you do not choose any label the item will not appear in the widget
  • Image Size: Controll image size and resolution (Just for the big picture)
Widget Four - For Side Bar
Widget Three

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Four' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • Count Of Post: Control the number of posts
  • Enable Widget Name: You can enable/disable the definition and classification bar above the tool.
  • See More: Name of conversion to Category (possible to change)
  • Style: You can choose between two ways for the widgets to appear.
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Controll image size and resolution
Widget Five - For Side Bar
Widget Three

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Five' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • Count Of Post: Control the number of posts
  • Enable Widget Name: You can enable/disable the definition and classification bar above the tool.
  • See More: Name of conversion to Category (possible to change)
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Controll image size and resolution
Widget Six
Widget Six

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Six' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Six
  • Count Of Post: Control the number of posts
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Controll image size and resolution
Widget Seeven
Widget Seeven

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Seeven' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Seeven
  • Title: Short Title
  • Description: Short Description
  • Category: You can put up to 3 categories, if you leave them blank they will be selected on the latest published posts
  • Image Size: You can control the size of the images for the primary image, but for secondary images inside a circle it is set by default to 150x150.
Widget Eight - For Side Bar
Widget Three

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Eight' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • Count Of Post: Control the number of posts
  • Enable Widget Name: You can enable/disable the definition and classification bar above the tool.
  • You Can See Also: Just Name (Possible To change)
  • Category: Show posts by category, or show the latest posts if the category is not selected
  • Image Size: Controll image size and resolution (Recommended 150x150)
Widget Nine
Widget Nine

This is how the widget looks on the site and you will get a set of control options.

After dragging the widget 'Nine' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Nine
  • Enable Widget Line: Enable the top line
  • Enable Category Name: Enable Category Name in Top Line
  • Category: You can choice categories, if you leave them blank they will be selected on the latest published posts
  • Image Size: You can control the size of the images .
Category - For Side Bar
Category 1 Category 2

This is how the widget looks on the site and you will get a set of control options.

After dragging the 'Category' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • Display as DropDown: The category will appear as a drop-down list.
  • Enable Category Name: You can enable/disable the definition bar above the category.
  • Category Name: Just Name (Possible To change)
  • Style: You will be able to switch between two forms of the tool.
Archive - For Side Bar
Category 1 Category 2

This is how the widget looks on the site and you will get a set of control options.

After dragging the 'Archive' to the place where you want them to appear on your site, the following control menu will appear for you:

Widget Three
  • Display as DropDown: The category will appear as a drop-down list.
  • Enable Archive Name: You can enable/disable the definition bar above the category.
  • Archive Name: Just Name (Possible To change)
  • Style: You will be able to switch between two forms of the tool.
Social Media - For Side Bar
Category 1 Category 2

In order to be able to add your social media, you have to go from the WordPress control panel to 'santana panel > social media'

in This Section You can add any number of social media

  • Yoy Can Add New Social Mesia by Click 'Add New Social Media'
  • Yoy Can Remove New Social Mesia by Click 'Remove Social Media'
  • In the 'Social name' field enter the name of the site of soacial
  • In the 'Social Icons' field you can enter the site icon and you can get it from the bootstarp site and it comes as an example 'i class="bi bi-facebook">
  • In the 'Social Method' field you can enter the type of subscription such as 'Like' or 'Follow'
  • In the 'Social Link' field you can add your account link
Category 2

This is how the widget looks on the site and you will get a set of control options.

After dragging the 'soacial' to the place where you want them to appear on your site, the following control menu will appear for you:

Social Media
  • Enable soacial Name: You can enable/disable the definition bar above the soacial.
  • soacial Name: Just Name (Possible To change)
  • Style: You will be able to switch between two forms of the tool.
About Us Widget - For Side Bar
Category 1

This is how the widget looks on the site and you will get a set of control options.

After dragging the 'about us widget' to the place where you want them to appear on your site, the following control menu will appear for you:

Category 1
  • uplead logo:You can upload any image, but it will be reduced in size in the display.
  • Description:A short text excerpt about the site or the site owner.
  • Enable Social Media:Enable social media buttons (they can be created social media button from 'santana panel > social media')
Contect Info Widget - For Side Bar
Category 1

This is how the widget looks on the site and you will get a set of control options.

After dragging the 'Contect Info Widget' to the place where you want them to appear on your site, the following control menu will appear for you:

Category 1
  • Contect Name
  • Location
  • Email
  • Phone Number
  • Enable Social Media

# General Options

From the WordPress Dashboard, you will find the 'Santana Panel' option, and from there, a list will appear for you to control your template.

Widget zero

The first option that will appear for you is the 'General Option' option, which contains some initial settings for the template.

  • #1 Global Premary Color: You will be able to control the Premary color of the template, we tried to put the color in a fair and non-distracting way and at the same time beautiful٫
  • #2 Contrast Color: We set the premary color of the template to some elements that contain texts, and to avoid incompatibility between the premary color and the text color, we set the option to control the text color for compatibility.
  • #3 Set Website Logo: The option to add a logo will allow you to choose any image you want as a logo for the site, and this logo will be placed in the top navbar of the site and above the search bar on the site.
  • #4 Set Website FavIcon: FavIcon is the logo that appears in the browser window when open your website, so we integrated this option directly into the template options for quick access.
  • #5 Font: For the font option, we set the "League Spartan" font as the main font when installing the template, but we added some other fonts if you don't like the original font, and because of the layout of these fonts we put an option to control the size of these fonts.

# Home Page

If you go to the 'Posts' option from the Santana control panel, you will see two control options, the first for the 'home page' and the second for the 'article page'.

Widget zero

In the first part we will look at the 'In Home Page' option.

Widget zero

In this option you will find control options such as:

  • Home Page - Last Post:

    This option is for pinned posts or recently added posts, and will appear even if you do not choose any settings.

    This option has 3 settings.

  • Last Post Featured Image SizeCette option vous donne la possibilité de contrôler la taille de l'image, car l'image sera recadrée et réduite en taille selon l'option que vous choisissez.

    Note: Download the plugin - Real Thumbnail Generator: - to revert image size settings to their original settings if this option does not respond.

  • Pagination Style: This option gives you the ability to switch between two Style of Pagination.
  • Enable Hidden Slide MenuEnable/Disable the slider bar
  • NavbarYou can control the top bar by Enable/Disable, in addition to the option to Enable fixing the top bar or make it move with the page.
  • Enable SideBar sticky: Enable/Disable sideBar
  • Enable Leading Animation: Enable/Disable the leading Animation before the page content is fully loaded
  • Enable Footer: Enable/Disable The Footer

# Article page

In the Post Page Control you will find control options such as:

  • Blog Info Style: For this option, you will get two different Style For View The (Featured Image, Title, Comments, Author, and View Counter, Publish Date)
  • Navbar: Enable/Disable Navbar
  • Enable Hidden Slider Menu:Enable/Disable Slider Menu Slider Menu
  • Table Of Content: This option will add several control settings to the article's navigation menu or Table Of Content.

    you will get

    • Enable table of contents
    • Show table of contents within article
    • Show table of contents in sidebar
    • Table Style: Choosing between two Style table of contents formats

    Note: When you open the site on mobile devices and at the same time you select to display the table of contents in the sidebar, it will be automatically removed from the sidebar and moved to the inside of the article.

  • featured image Size: Cette fonctionnalité vous permettra de contrôler la taille de l'image en termes de dimensions ou de taille d'image.
  • sidebar:
    • Enable Side Bar: For this option, if you activate it, a sidebar will appear with the ability to add any tools to it, but if you deactivate it, the sidebar will be removed from the page and then the main content such as the article image and the article will be moved to the middle of the page.
    • Enable SideBar sticky: For this option the sidebar will be fixed when you scroll up.
  • Headings Color: For the titles, we have added a line under each heading title in the article.

    By default, a custom default color has been selected, but through the heading color control settings you will be able to change all the color lines (h2, h3, h4, h5).

  • Auther Info This option will give you the ability to display the author information, and you will get:
    • Enable/Disable Author Information
    • Two Style of author information
    • Author Description
  • Enable Tags: This option allows you to show tags
    • Enable/Disable tags
    • Two style of tags
  • Leading Animation: Enable the option to wait until the entire page is loaded via loading animation
  • Pagination Style:This option will give you two style of navigation options between posts.

    The first option will show only the title of the previous or next post.

    while the second form will show you the title of the previous or next article in addition to the post image.

  • Footer: This option activates the Footer on the posts page.

# Pages

Custom Pags

Currently, only one page is Created, which is the 'Contact Us' page.

You can activate this page via WordPress page > page > new page.

Currently, to activate the feature, you need two things:

Contact Form 7 Plugin, which you can download from the Santana Panel > Requirements Plugin

Activate the plugin, log in and copy the code from 'Shortcode'

Contect Form

Now go to the pages section and create a new page and put the code you copied in the writing section, then choose from 'Template' > 'contact Form'

Contect Form

Normal Pags

For normal pages only we tried to make them empty, leaving the footer and navbar so that it is easy for you to customize them using external tools like elementor.


# Page Controller

In the 'control panel' option, you will see 5 pages control options, This Page is:

  • Category Page
  • Search Page
  • Archive Page
  • Auther Page
  • Tags Page
Widget zero

In all pages options you will get the same control options, so we will talk about one page which is 'category' and its settings explanation will apply to other pages.

  • Navbar: Enable/disable Top Navbar
  • Hidden Slide Menu: Enable/disable hidden slider
  • Leading Animation: Enable/disable Leading Animation
  • Footer: Enable/disable Footer

Note: For pages like (Tags, Author, Archive) you will get the same Widgets that is set in 'Category' through 'Appearance > Widgets'.


# Meta Open Graph



Widget zero

In the 'Meta Open Graph' option, we tried to solve one of the problems while publishing the site on one of the social media.

The problem occurs when you publish the home page link on any social media platform, so any image taken from your site appears to you or an empty image appears.

This option gives you the ability to specify the image that will appear if you want to publish the link to your main site on social media.


# Social media



Social Media

Here you will control your social media, and for your information we do not limit you how many sociam media to add.

We built a way to display and control social media from scratch to provide you with the ability to display any social media button you want in addition to its shape or name and other options.

In the control options we added buttons for you such as adding a new social media site or the option to remove a social media exist.

With control options such as (the name of the social media, the image of the social media site, the method of communication, your link on the social media site).

We have integrated this option into many of the widgets in the template and you have the option to display or prevent them.

Note: In order to add a social media icon, you can go to the website bootstarp site and choose the social media icon you want to add.


# ADS Controll

ADS In Single Page - Content Page

With this option, you'll be able to control the display of ads on the following pages:

  • Articles page
  • Pages
  • Archive, Author page, Search page, Archive page, Tags page (other page)
ADS

We have provided guidelines for the placement of each ad so you won't need an explanation.

but for the (Other Option) section we have combined the same ads into pages such as Archive, Author page, Search page, Archive page, Tags page so the same ads will appear on these pages.


# Custom Code

This Section allows you to add custom JavaScript or CSS codes, but we warn you against adding codes from unknown or untrusted sources.

Contect Form

# Error Page


  • Page Title: This option appears in the window bar (by default set to 'Error Page - 404').
  • Page Error Name: Shows you the type of error (by default set to '404').
  • Error Note 1: Fact 1 about the error (by default set to 'Look like You're Lost')
  • Error Note 2: Fact 2 about the error (by default set to 'The Page You Are Looking For Not Available!')
  • Go Home Button Color: You can control the background color of the home page back button.
  • Style Of Error: you can choose between 2 error animation
  • Ads 1: This Ads Run Before Return buton Home
  • Ads 2: This Ads Run After Return buton Home


Error Page

# More Option

Here, you'll see some control and editing options, such as:

  • Enable/disable The CopyRight Text: (You'll be able to enable or disable copyrights and edit the text)
  • Enable/disable pages in Footer
  • Enable/disable the scroll To Top button
  • Enable/disable the footer search button
  • Enable/disable WordPress login page customization (you can add a custom image via the image link)
  • Change the footer top line color
Error Page

# Changelog

Version 1.0.0

  • Initail Release