EXLIBRIS – Documentation

Introduction

 

Thank you very much for choosing EXLIBRIS, the third theme of RAMSTHEMES. We truly appreciate and really hope that you’ll enjoy our theme and our future updates and improvements. If you have any questions or recommendations, feel free to contact us.

Requeriments

  • WordPress 4.6 (or above)
  • PHP 5.6 (PHP 7 recommended)
  • Basic Knowledge of WordPress (create posts, install plugins, fill fields, etc.)

As you know, you can always visit the demo site here

 

Installation

When you purchase the theme, the downloaded zip file contains:

  1. demo files (it contains the files for images and exported data for cloning the demo site)
  2. theme files (it contains the zipped installable WordPress theme file)

Extract the downloaded zip, and select the zip file exlibriswp.zip. Now, you have two ways for installing the theme:

> In the next screen click the Upload Theme button

 

Activate Plugins

When you install and activate the Theme, there’ll be a message with a list of required and recommended plugins.

Required: Advanced Custom Fields Pro, RAMSTHEMES Addons, WP User Avatar, WooCommerce

Recommended: Classic Editor, Contact Form 7, Yoast SEO

Optional: All-in-One WP Migration (but required only if you want to import demo content)

 

 

 

You can go to Appearance – Install Plugins section and install them

 

 

Setup Demo

If you want to import the demo to your WordPress installation (looks exactly the same as demo site), when you make a clean install of WordPress on your server and before the activatation of theme, download the All-in-One WP Migration plugin and activate them. Now, go to Import page from the all-in-One WP Migration dropdown menu:

Once you have chosen the option, the application takes you to the Import page:

From this page you can select from where you want to import a backup using the dropdown menu:

If you chose ‘File’, the plugin will open a window showing your local files and folders and will let you chose a backup for import from there. Then, extract the zip file exlibrisdemo.zip from the Demo Content folder. Next, a file called exlibrisdemo.wpress appears. Choose them to begin the import process:

The import has an additional step which warns you that your website will be overwritten by the new backup including database, media, plugins and the activated theme. This is the last step from which you can cancel the process. After pressing ‘Proceed’ you cannot stop the import process anymore. The amount of time the import process will take depends on the size of the data and the speed of your internet connection.

Note: is important to previously check in your Hosting Service the File Size Upload option (128 MB recommended size, because the size of the import file is 110MB)

When finished, a successful import will display this message:

At this step, it is recommended to click on Permalinks Settings link and save your permalinks twice in order to save them and generate .htaccess file.

Also, because the demo imports the original database, your admin user, mail and password keys will change to:

admin
5&CoF6g3Dx

Please, enter with this keys to your dashboard and change all to whatever you want.

Building Custom Menu

Go to Appareance – Menu in the Dashboard and build the menu (sidenav and main) with the elements you like. After that, check the Display location in Menu Settings and Save Menu to display it in the sidenav (the left sidebar menu) or main menu (the three-dotted menu).

Navbar selector

Logo in navbar

In addition to configuring the navbar, you can upload two logos, one for the Normal (light) mode and other for Dark mode, if you wish to enable them. Recommended logos in PNG or SVG format for better definition.

 

Other options are:

Navbar Shrink: shrink effect when you choose a bigger logo (major navbar and logo heights).

Navbar / Logo height: the height of the header navbar and/or logo in pixels.

Sidenav icon color: choose color for the dotted and hamburger menu.

Blog Layout

Common options:

Blog on home: enables or disable blog posts on homepage.

Blog title: the custom name for display title of the section (i.e, “New articles”).

View all button: display a link to the Blog page.

Blog page: select the Blog page that contains all the posts.

Post columns: select the column qty for the Blog page.

Post qty (home): select the qty of posts showed in home page block.

Display data: show the info of the other buttons Outside (all) or Inside (date, categories and excerpt) the image square.

Display categories: displays the category of the post (only on home page).

Display Time: shows the date of post, configured on WP settings section.

Display excerpt: shows post excerpt.

Display tags: shows the tags assigned to post.

 

In the example is builded the “New articles” block.

Blog page:

Theme Settings - Options

Spacing: the external margins or “streets” between the columned-squares of the grid. Select from 0 (no margin) to 3, respecting the Boostrap margin class (4 and 5 not included because it reduces too much the size of the squares).

Use Fade effect for load pages: activate a simple fade effect when a page is loaded.

Activate Load Bar: activate a thin load bar when a page is loaded, similar to YouTube.

Load Bar color: select a custom color for the thin load bar when activated.

Fixed Navbar: changes the header to a fixed position, making the entire navbar visible when scrolling.

Border navbar: adds a border-bottom line to header navbar.

Border menu: adds a border-right line to sidenav menu.

Side menu font size: sets the size in px of the side menu sections.

Display sidenav: show or hide sidenav.

Sidebar in pages: enables the same sidebar of posts in pages.

Rounded Corners: styles all the images and borders with a little rounded corner style, similar to an “app-like” style.

Social Media Buttons: used for the default social media buttons. Disable if you’re using another plugin or social share tool (we recommend the ShareThis .js integration and Yoast SEO for metadata).

 

Styling and Color Customization

 

Dark Mode Switch: enable or disable the switch for the two modes on the top-right corner of the header.

Hover color for Dark Mode: the hover color for links, only when dark mode is enabled on frontend.

Body text color: the general color of the texts.

Body background: bg color for the whole background of the site.

Hamburger menu color: colorize the hamburger “three line” menu.

Side menu background: bg color for the sidenav displayed when the hamburger menu is pressed.

Navbar background: bg color of the header.

Navbar text color: the general color of the menu buttons on the navbar.

Footer background: bg of the footer.

Link color: color for the links, or the <a> tag.

Hover color: color for the links when hovered.

Buttons background color: bg of the custom button class.

Buttons text color: text color of the custom button class.

Buttons background hover color: bg of the custom button class when hover it.

Buttons text hover color: text of the custom button class when hover it.

Elements hover color: color of the hover for product columns.

Comment card color: color of the comment card for post comments.

Home Product Slider

Activate product slider: enable or disable the section in home page.

View all button: show or hide a link to the category of the block.

View all color: select the color of the link.

Add product slider: select a category that contain books and set the qty to show in slider. Add the same sequence to display another slider block.

 

In the example are builded the “Novels” and “Philosophy” blocks.

Home Featured Books

Featured books: enable or disable the home page block.

Featured books preview: enable or disable the preview button, that shows side-info as preview chapters and PDF download.

Featured books title: the custom name for display title of the section.

Select featured books: simply select the books that appears in this block.

 

In the example is builded the “Featured Books” block

 

Home Featured items

Featured items: enable or disable the home page block.

Content position: basically the title and pre title, outside or inside the image.

Content color: the color of the text elements.

Featured title: the custom name for display title of the section.

 

The sliding elements contain a image, a mini pre title, the proper title and the custom link. In the example is builded the “Featured authors” block.

Home Product Categories

Categories: enable or disable the home page block.

View all button: show or hide a link to the category of the block.

Categories title: the custom name for display title of the section.

Categories page: select the page that contains all the categories.

Select product category: simply select the categories that appears in this block.

Categories columns: column qty. used for the block.

Product category title: select if the title is displayed outside or inside the image.

 

In the example is builded the “Explore” block.

Home Elements

 

Displays custom elements as images, titles and short texts, ideal for the typical “services” section of the home. Items must be configured in his own tab below,similar to previous sections for blocks:

Home Slider

You can enable a slider for the homepage and add the slides what you want, uploading image, setting the titles and description, sets the color of texts (White for colored images or Dark for more light-background images) and linking them to anywhere.

 

In the example is builded the “Just for you” block.

WooCommerce Extra Product Settings

Product columns: number of columns (2 to 5) for selected layout.

Infinite Scroll: enables the Infinite Scroll effect when scrolling down.

View more button: combines with the previous switch, enabling a button for show more posts.

Note: when the IS and VM buttons are disabled, the default WP paged navigation is automatically enabled.

Align Add to Cart Button: align the button to the bottom of every product column.

Sidebar in shop page: activates the dedicated WooCommerce sidebar for display widgets in shop page.

Display Cart on Navbar: displays the icon in top right position of the navbar.

Cart totals background: the color of the cart totals block in cart page.

Display add to cart (loop): show or hide the button in general Woo archive pages and dependencies.

Add to Cart text (shop and single): changes the text of the button in the single product page (i.e, “Add”) or Shop page.

Sale text/color: changes text and color of the “offer” icon placed in top-right zone of the product featured image.

Remove sorting dropdown/Result count: enable or disable them in the shop page.

Description/Additional info/Review tab: enable or disable the basic WooCommerce tabs in the single product page. If you disable the “Description” tab, another option will shown: Long description only, that displays the description content directly below the main area of product page.

Display Product Qty: enable or disable the qty. selector on single product page.

Display SKU: enable or disable the SKU (product code) and category on single product page.

Display short description: enable or disable the excerpt on product page.

Remove order notes: disable “order notes” textarea on checkout

Buttons background/text/hover color: customizes the color of the WooCommerce main buttons.

Review card color: color of the comment card for book reviews.

 

Examples of shop page:

Single product page:

 

Author List

Configures the options of the shortcode

[bookauthors]

displayed in a custom HTML Widget. The options are:

View all button: show or hide a link to the all authors page.

Select Book Authors page: select the page that contains all the authors.

Author name color (product): the color of author name in single product page.

Select authors: simply select the authors that appears in the widget.

 

Example of “Selected Authors” widget in bottom left:

Contact Page

Sets your contact info and displays the shortcode

[ramscontact]

to display the default contact form. To set it up, go to “Pages” in your Dashboard and create a Page, and select the template “Contact” in the “Page Attributes” box.

Fill the other fields with custom info. To embed map, copy and paste the code obtained in Google Maps website “share” option after the search of the location. This method no needs the creation of the Maps API key and register a credit card in Google Services.

 

Example of Contact page:

Custom map opened in side modal when “Open map” button is pressed

Social media links

You can simply fill the fields with the url’s of your fav and active social media profiles. They will be shown anywhere when you use the shortcode

[social]

Extra Pages

Create Blog page

Create a common WordPress page, name it “Blog” and select the template “Blog” in Page attributes. Save it, and ready to use.

 

Create Register page

WOOLF uses separate login (My Account) and register pages. In dashboard, go to WooCommerce settings and in the tab “Account & Privacy” uncheck the option “Allow customers to create an account on the “My account” page”. Now, create a common WordPress page, name it “Register” and select the template “Register” in Page attributes. Save it, and ready to use.

 

Create custom page with product categories

First, go to product categories in the dashboard “Products” tab, create a few categories and add a featured thumbnail to them. Now, in dashboard, create a common WordPress page and select the template “Product categories” in Page attributes. In the Content area, put the WooCommerce default Shortcode:

[product_categories]

 

Sources and Credits

* ACF Pro, © 2019 Elliot Condon, GNU GPL v2 or later.
* Bootstrap, © 2011-2018 The Bootstrap Authors, © 2011-2018 Twitter, Inc., MIT.
* PACE, © 2013-2018 HubSpot.
* Flickity, © 2019 metafizzy, GNU GPL v3.
* Infinite Scroll, © 2019 metafizzy, GNU GPL v3.
* Images Loaded, © 2019 metafizzy, MIT.
* Font Awesome, © Fonticons, Inc.
* Bootstrap Ekko Lightbox, © 2019 ashleydw, MIT.
* Bootstrap Comment Walker, 2017 Aymene Bourafai, GNU GPL v2.
* Bootstrap Gallery, 2016 Edward McIntyre – @twittem, Brandon Hubbard, GNU GPL v2.
* Bootstrap Drawer, , © 2015 Caroline Amaba, GNU GPL v2.
* TGM Plugin Activation, 2016 Thomas Griffin, @GaryJones, @jrfnl, GNU GPL v2.
* Simplebar, © 2019 Adrien Denat, MIT.
* Woo Align Buttons, © 2019 320up, GNU GPL v2 or later.