Thank you for purchasing this theme. If you have any questions or need support, please help me submit a ticket to http://support.roarapi.com
This theme is designed to use with Shopify only.
This documentation is made with Documenter
1. To active Responsive Checkout for your Shopify store, please go to Settings > Checkout and click Upgrade:
2. Learn more here:
Installation Shoes Theme is easy and quick.
If you already had the Shopify site and want to apply the theme to your site, follow the instruction below:
Download: rt-material.zip
1. In your backoffice go to: YOUR STORE > THEME:
Click: Upload a theme
Click: Upload
2. In your backoffice go to: YOUR STORE > THEME . At Unpublished themes section:
Click: Publish
If you have error as below:
This happens when you are trying to upload the incorrect .zip to Shopify. 99% of the time this happens when the folder that was downloaded from Themeforest was NOT unzipped beforehand.
Within the folder there are 4 items – Readme.txt, Changelog.txt, Documentation folder and Packages folder. The file you have to upload to Shopify is a .zip file in Packages folder (rt-material.zip).
To customize this theme's appearance and settings
In your back-end go to: YOUR STORE > THEMES:
Click: Customize theme
In your Customize theme:
Overview:
If you want to change the theme's codes, please choose Edit HTML/CSS:
Changing source code:
To enable RTL support languages, please go to Customize themes > General > RTL style
If enabled, almost common texts (heading, title, etc...) will be in light font style
Go to: Customize theme > Colors, Typography > Scaffolding
Go to: Customize theme > General > Page Selector
This theme support Google Web Fonts (500+ free fonts and more). To use this feature, all you have to do is putting the Google Font names exactly
Go to: Customize theme > General > Fonts
Go to: https://www.google.com/fonts
Find your font in search field on the left hand
Click Quick-use button
Scroll to 4. Integrate the fonts into your CSS section, and only copy the words as below image
Go to: Customize theme > General > Fonts > paste into Google Web Font field
If you have OTF font and you want to use for your store, this theme supports this. Please follow the instruction below:
Go to: Themes > Edit HTML/CSS
Within Assets folder, please upload 2 OTF font files, one is 'myfont.otf' and one is 'myfont-bold.otf' (the name must be as given)
These files represent for 2 states of the font: normal & bold
Go to: Customize theme > General > Fonts
Choose 'My own font', like this:
You can set logo with image or text
Go to: Customize theme > Header > Site Logo
Go to: Customize theme > General > Favicon
If you are on the front-end, you can see a plus symbol at the top-right corner. Clicking this will open the Sliding Bar
To config, please go to Customize theme > Sliding Bar
For the top, you will have 4 widgets: Image Widget, Link-list, Text Widget, Social Media Icons and Feedback
The top banner is a good idea to show up your announcement or promotion to your customers
To config, please go to Customize theme > Top
To config, please go to Customize theme > Header
To enable customer accounts, select Settings > Checkout > Customer accounts. There are three options available, as noted below.
Go to: Settings > Checkout > Customer accounts
Go to: Customize theme > Header > Customer links
Review in front-end
Go to: Customize theme > Header > Cart info
Review in front-end
Go to: Customize theme > Header > Search
Review in front-end
The top area allows you to display additional info. You can put a top menu, a mesage, hot-deal or social icons here
Go to: Customize theme > Header > Top menu
You can see all settings here
!!! IMPORTANT:
We recommend you using 1380-pixels-width images for Full width placement, and 1140-pixels-width for Within container placement. Please note that all images must be the same dimension - for best displaying. Our demo is using 1380x600 pixels images.
Go to: Customize theme > Slideshow
Review in front-end
This theme comes with a very flexible Slideshow. So, you can personalize it as much as you can:
Slider mask is an opacity layer covering only on images of the Slideshow. It helps enhancing the contrast between images and texts so that it is more readable:
!!! IMPORTANT:
In case you want to use video for the slide, please refer Upload a Video instruction to learn how to get the direct link
This theme also allows you to adjust the texts position for slider
Sometimes simple texts cannot express exactly what you want, and you want more than that? You want to add image / sticker to slider instead of texts?
!!!NOTE:
when slide sticker is enabled, the Heading & Caption will be disabled automatically
!!! IMPORTANT:
You can only use either video or slideshow at a time. If both are selected, only slideshow is enabled
Go to: Customize theme > Video
!!! IMPORTANT:
please refer Upload a Video instruction to learn how to get the direct link
In Admin, go to Settings > Files and click Upload files to upload your video.
After uploaded, you will have video URL. This is the direct link
After having the direct link of the Video, you can copy it for Homepage Video or Slider Video
Go to: Customize theme > Homepage > Special Offers
Go to: Customize theme > Homepage > Featured Products
Go to: Customize theme > Homepage > Our Collections
Go to: Customize theme > Homepage > Static Block
Go to: Customize theme > Homepage > Lookbook Block
This widget displays a set of collections (up to 10 collections supported)
For every single collection, you can set associated image & text
The widget uses a dropdown to switch between collections
Go to: Customize theme > Homepage > The Collection
Go to: Customize theme > Homepage > Promotion block
(*)
you can set icon as you want by replacing fa-user by another. For full list of icons, please go to Font Awesome Icons
Go to: Customize theme > Homepage > Blog block
This widget displays "partners" (images) as a slider
Go to: Customize theme > Homepage > Our Partners
This widget displays your Instagram or Flickr photos
Go to: Customize theme > Homepage > Photo widget
(*)
for Instagram or Flickr account settings, please go to Customize theme > Social Config
This theme comes with a new collection page, which is more customizable & mobile-friendly
Many new features: collection slider, advanced filtering module...
Go to: Customize theme > Collection Page
Review in front-end (Grid mode)
Review in front-end (List mode)
You can put a slider at the top of the collection page
You can set up to 5 images for the slider
Go to: Customize theme > Collection Page > Slider
Besides Filtering By Tags, this theme includes a new filter called Collection Advanced Filtering
Go to: Customize theme > Collection Page > Filtering then select Filter By Groups
This filter is displayed in both vertical mode (in sidebar) and horizon mode (in a bar on top) to help improving user experience
Understanding the structure of the filter:
There are many filter items (from now we called a filter item "filter" as abbreviation)
To the image above, you can see there are 4 filters (Color, Size, Price, Brand)
To each filter, there are many values. For instance, Color has its value: beige, black, blue, gray, green, pink, red, silver and yellow.
When a value is selected, for instance "green", all products (in the collection) having "green" tag will be displayed
The filter Color is displayed in swatches by default
Go to: Customize theme > Collection Filtering
The image above contains the settings for one filter
Just do the same for others
This theme supports up to 10 filters
Select Use to enable the filter
Enter your filter heading into Heading and its values into Filters
Note that you have to separate each value by a comma
Besides using Shopify's default paging, you can also use our infinite scroll module. This helps users browse your store without re-loading the page when you have many products
Go to Customize theme > Collection Page > Infinite Scroll
Go to Customize theme > Collection Sidebar
Go to: Customize theme > Product Page > Look and Feel
Go to: Customize theme > Product Page > Promotion Block
Go to: Customize theme > Limited edition
Go to: Customize theme > Social Config > Social Sharing
Go to: Customize theme > Product Page > Collection Beneath Product
Go to: Customize theme > Product Page > Recently Viewed Products
Go to: Customize theme > Product Page > Sale off logo
Go to: Customize theme > Product Page > Look and Feel
In Admin, go to product you want > Images and edit ALT value of the Featured image:
What you need to paste here is the embedded code from common video networks such as Vimeo, YouTube...
Review in front-end
Go to: Customize theme > Product Page > Tweet to get Discount Code
Review in front-end
!!! IMPORTANT: You must install Product Reviews app before modifying these settings.
Go to: Customize theme > Product Page > Product Reviews
Review in front-end
Go to: Customize theme > Blog Page
To add thumbnail, go to Blog Posts > choose your article > in Excerpt section click Show HTML
Review in front-end
Creating or opening up your Contact Us page
Adding some content to your Contact Us page (or not)
Assign the page.contact template to your Contact Us page
Go back to your Contact Us page in your shop admin.
Select 'page.contact' in the Template drop-down like so:
Go to: Customize theme > Contact Page
Review in front-end
Go to: Customize theme > Cart Page
Review in front-end
This theme comes with a wishlist app called RT-Wishlist, which is developed by RoarTheme. If your Material theme license is legal, you have the right to use it for free.
To use Wishlist, you have to finish 2 steps:
Go to https://apps.shopify.com/rt-wishlist to get the app. If you are prompted to log into your store, just do it
Confirm the installation:
Enter the purchase code of your theme & click Save. If you don't know how to get the purchase code, please refer here
Go creating a page for wishlist. Please note that you must set the Template as page.wishlist
Go to: Customize theme > Wishlist Page and choose the page you just created
Save your settings
Here's a quick way to change some of the more commonly text
Go to: Themes > Edit language
Go to: Pages > Add page and press Show HTML
Press: Add FAQ button to add new FAQ
Press: General FAQ button to general new html code
Copy your new html code and Paste to your FAQs page
Review in front-end
Assign the page.faq2 template to your FAQs page
Go back to your FAQs page in your shop admin.
Select 'page.faq2' in the Template drop-down like so:
Review in front-end
Go to: Customize theme > About us Page
Go to: Customize theme > Password Page
A lookbook page contains a collection of photographs compiled to show off models or styles (especially in clothing)
The lookbook page has become a staple for store owner showcasing new collections through images that convey a “feel” or story for the new season
This theme supports up to 2 lookbook styles:
Style 1:
- In the left column, the image of each item can be large (lookbook 1) or medium (lookbook 2, lookbook 3), while in the right one, the image is medium only
- Each item has its own heading and caption
Style 2:
- The lookbook has many sliders, each one containing many images
- On each slider, you can put a content (the black wrapper) with heading and call-to-action button, on the left or on the right
- To the picture above, there are 3 sliders with 3 different styles (right content, left content, no content)
- You can add sliders as much as you can
Style 1:
1. Go to RoarTheme Lookbook Creator Tool http://docs.roarapi.com/shopify/material/lookbook_v1
There are 2 "Add New" sections for left column right column, just choose the one you want
2. Cliking the "Add New" will open a pop-up, here you can:
- Image URL: enter your image URL here
- Size: large or medium. Note that this option is not valid for the right column
- Heading: enter the heading. HTML is allowed if you want
- Caption: enter the caption. HTML is allowed if you want
3. Click "Generate Code" to get the HTML code
4. Copy the HTML code from the box below
5. Go to your Pages section in your store admin
6. Creating a page for lookbook then click the <> icon to switch to HTML mode
7. Paste the copied code here then save changes
Style 2:
1. Go to RoarTheme Lookbook Creator Tool http://docs.roarapi.com/shopify/material/lookbook_v2
There are 2 sections: Lookbook Content & Lookbook Images. The LookBook Content is where you set up the content on the slider. The Lookbook Images is where you add the images
2. There are options for the content:
- Placement: as mentioned above, the content is optional. In case you don't want it, just select "None". Otherwise, choose Left or Right
- Heading: enter the heading
- Call-to-action: enter the text on the button
- Action URL: the link when you click on the button
3. Click Add new on Lookbook Images section to add an image to the slider
Each time you finish adding the image, the preview of the lookbook (slider) will be displayed
4. Click "Generate Code" to get the HTML code
5. Copy the HTML code from the box below
6. Go to your Pages section in your store admin
7. Creating a page for lookbook then click the <> icon to switch to HTML mode
8. Paste the copied code here then save changes
Where do I get my MailChimp Form Action?
Those themes contain a theme setting called MailChimp Form Action or something similar. The MailChimp form action is the only piece of information the theme needs to hook up its signup form to your MailChimp account.
Requirements
To complete this tutorial, you will need:
If you're using a mobile device, the screenshots in these instructions might not be entirely accurate. If you can't see MailChimp menu options at any time, try clicking the More button at the top left of the screen.
To obtain the code for your MailChimp Form Action:
1. Log into your MailChimp account.
2. Click the Lists button in the left navigation bar.
3. Click the drop-down box on the right, and choose Signup forms.
4. Choose Embedded forms.
5. On the Embedded form code page, click on Naked.
6. Scroll down and locate Copy/paste onto your site.
7. Double-click anywhere in the box to select the code.
8. Copy the code to your clipboard (use CMD-C for Mac or CTRL-C for Windows).
10. Paste the code into any text editor so that you can view it.
11. The only line of this code that you need is the action attribute value in the opening form tag. Reading from the top of the code, it's located between the second set of quotation marks. Don’t select the quotation marks themselves, just what's inside them.
Copy the selected action attribute value to your clipboard.
12. In a new tab, open up your shop admin.
13. From your shop admin, click Themes to go to your Themes page.
14. Click on the Customize theme button.
15. Now you need to locate the MailChimp form action field in the Customize theme. It might be called Mailchimp form action URL, or MailChimp Form Action, or similar. Its location varies from one theme to another, but it's most likely to be in the header, footer, or home page section.
16. Paste the action attribute value into the MailChimp form action field. In the Your theme, the field looks like this:
17. Save your changes.
18. Test things out by subscribing to your own MailChimp newsletter.
Those themes contain a theme setting called Campaign Monitor Form Action or something similar. The Campaign Monitor form action is the only piece of information the theme needs to hook up its signup form to your Campaign Monitor account.
Requirements
To complete this tutorial, you will need:
To obtain the code for your Campaign Monitor Form Action:
1. Log into your Campaign Monitor account.
2. Click the Lists & Subscribers button in the top navigation bar.
3. Click the subscriber lists as you like.
4. Choose Grow your audience in the right navigation bar.
5. Click on Copy/paste a form to your site.
6. Scroll down and click Get the code.
7. Double-click anywhere in the box to select the code.
8. Copy the code to your clipboard (use CMD-C for Mac or CTRL-C for Windows).
10. Paste the code into any text editor so that you can view it.
11. The only line of this code that you need is the action attribute value in the opening form tag. Reading from the top of the code, it's located between the second set of quotation marks. Don’t select the quotation marks themselves, just what's inside them.
Copy the selected action attribute value to your clipboard.
12. In a new tab, open up your shop admin.
13. From your shop admin, click Themes to go to your Themes page.
14. Click on the Customize theme button.
15. Now you need to locate the MailChimp form action field in the Customize theme. It might be called Mailchimp form action URL, or MailChimp Form Action, or similar. Its location varies from one theme to another, but it's most likely to be in the header, footer, or home page section.
16. Paste the action attribute value into the MailChimp form action field. In the Your theme, the field looks like this:
17. Save your changes.
18. Test things out by subscribing to your own MailChimp newsletter.
Go to: Customize theme > Extentions > Popup Mailchimp
Review in front-end
1. Click the Share link under the video.
2. Click the Embed link.
3. Copy the code provided in the expanded box. This is the embedded code.
1. Click the Share icon on the video.
2. The embedded code is in the Embed section. Just copy it.
1. Click the Share link under the audio.
2. Click the Embed link.
3. Copy the code provided in the expanded box. This is the embedded code.
Go to: Customize theme > Header > Currencies switcher
Go to: Settings > General > Standards & formats
If you want to decorate your store for Winter/Christmas, this theme supports snow effect and background music
(!!!) If you want to use background music, first, please upload your 'xmas_music.mp3' file into Assets
Go to: Customize theme > Winter Settings > Enable snow effect
Go to: Customize theme > Winter Settings > Background Music
This slider is a type of Tabs Slideshow. It also allows you to put a linklist (menu) on each slide. It is put right below the Special Offers widget by default
Go to: Customize theme > Promotion Slider
General Settings
Individual Slide Settings