Overview
Magento 2 B2C package by BSSCommerce is the complete retail solution to help your site sell better, bigger, and easier.
The package contains 5 quintessential modules:
- Magento 2 SEO extension
- Magento 2 Popup extension
- Magneto 2 One Step Checkout extension
- Magento 2 Guest to Customer
- Magento 2 Social Login extension
I. Magento 2 SEO Extension
Please go to Store ⇒ Configuration ⇒ BSSCOMMERCE and start configuration.
1.1. In SEO Core
In Enable Custom H1 Page: Choose Yes to enable or No to disable this function.
When you choose Yes, you go to the Search Engine Optimization of each category, CMS or product edit page to enter a customized Heading 1.
This feature is very useful for store owners in specific cases.
For example: you run a promotion for a product A and want to place an eye-catching Heading 1 without changing the product name (the H1 as the default setting), you can enter a custom H1 like “Hot Deal 50% OFF Strive Shoulder Pack | Today Only”. Customers now see the new heading on the product page replacing the original heading 1. However, the product name is unchanged anymore and is still displayed in the shopping cart and checkout page.
In Google Site Verification Code: If you are using Google Search Console, you need to enter the code provided by Google. This helps the module to show you impressions, clicks, CTR,... from Google Search Console.
For example:
- Meta tag provided by Google as below:
<meta name="google-site-verification" content="_rHp4oQoxOfKF8VN85ZiKWEZO_5ThgO8r7HaIKKJ0eI" />
- You enter this code to the field: _rHp4oQoxOfKF8VN85ZiKWEZO_5ThgO8r7HaIKKJ0eI
In Bing Verification Code: Bing also provides verification code as meta tag.
For example:
- Meta tag provided by Bing as below:
<meta name="msvalidate.01" content="9FD50240145DBB177642FF639FD4A222" />
- You enter this code to the field: 9FD50240145DBB177642FF639FD4A222
1.2. In Rich Snippets
In Enable: Choose Yes to enable the feature or choose No to disable it.
1.2.1. Site Structure
In Sitename in Search Result: Choose Yes to show the website name you assign in the search result, otherwise choose No. If you choose No, the Show Search Box in Search Result will be disabled.
In Website Name: Choose the name for your website to be displayed in the search result.
In Website Description: This description is applied to all pages as a default one (excepted for product and category pages).
In Website Image: Choose an image for your website to be displayed when sharing via Open Graph on Facebook and via Twitter Card on Twitter.
In Show Search Box in Search Result: Choose Yes to show a specific search box for your website, otherwise choose No.
In Twitter Username: Enter Twitter Username with @ to support Twitter card.
In Show breadcrumbs: Choose Yes to show breadcrumbs (show navigation path) of product pages instead of the regular URLs in the search result, otherwise choose No.
1.2.2. Local Business
In Enable Local Business: Choose Yes to show the following information of your website in the search result, otherwise choose No. If you choose No, all the following settings will be disabled.
In Business Type: Select your suitable business type from the drop-down list.
In Logo: Choose a logo of your business.
In Name of Business: Choose a name for your business to be displayed in the search result.
In Email: Enter your business email.
In Telephone: Enter your business phone.
In Price Range: Enter the price range of your business.
In Locality: Enter the locality of your business.
In Street Address: Enter your business street address.
In Country: Enter country of your business in two capital letters following ISO 3166-1 alpha-2 country code.
In Post Code: Enter your business post code.
In Social Profile Links: Enter your business social profile links. Please enter one link per line.
⇒ For more information about these store properties, explore HERE!
1.2.3. Product Options
In Show Name: Choose Yes to show the product name in the search result, otherwise choose No. If you choose No, all the following settings will be disabled.
In Show SKU: Choose Yes to show the product SKU in the search result, otherwise choose No.
In Show Image: Choose Yes to show the product image in the search result, otherwise choose No.
In Show Description: Choose Yes to show the product description in the search result, otherwise choose No.
In Show Review: Choose Yes to show the product review in the search result, otherwise choose No.
In Show Avg. Rating: Choose Yes to show the product average rating in the search result, otherwise choose No.
In Show Price: Choose Yes to show the product price in the search result, otherwise choose No.
In Show Availability: Choose Yes to show the product availability (in stock/out of stock) in the search result, otherwise choose No.
In Show Conditions: Choose Yes to show the New condition of products. We support the New attribute to appear in the search result.
In Add Category: If you choose Enable, the category path is added to the product URL displayed in SERPs.
In Add Brand: Select an attribute code of the brand to appear in the search result.
In Add Gtin: Select a GTIN to display in the search result.
In Custom Properties: Customize any Rich snippet and assign it to an attribute. You need to enter custom properties following the Rich snippet structure. Otherwise, you face issues when checking your website on Google Structured Data Testing Tool.
1.2.4. Category Options
In Show Name: Choose Yes to show the category name in the search result, otherwise choose No. If you choose No, all the following settings will be disabled.
In Show Description: Choose Yes to show the category description in the search result, otherwise choose No.
In Show Product Offers: Choose Yes to display offers of products in the search result, otherwise choose No.
In Show Image: Choose Yes to show the category image in the search result, otherwise choose No.
1.2.5. Open Graph
In Enable for Product Page: Choose Yes to enable Open Graph when sharing Product Pages via Facebook, otherwise choose No.
In Enable for Category Page: Choose Yes to enable Open Graph when sharing Category Pages via Facebook, otherwise choose No.
In Enable for Website: Choose Yes to enable Open Graph when sharing your homepage via Facebook, otherwise choose No.
1.2.6. Twitter Card
In Enable for Product Page: Choose Yes to enable Twitter Card when sharing Product Pages via Twitter, otherwise choose No.
In Enable for Category Page: Choose Yes to enable Twitter Card when sharing Category Pages via Twitter, otherwise choose No.
In Enable for Website: Choose Yes to enable Twitter Card when sharing your homepage via Twitter, otherwise choose No.
1.3. Google XML Sitemap
To configure XML sitemap for your Magento 2 store, please follow these 2 steps:
- Step 1: Configure the extension settings as your wishes at Stores ⇒ Configuration ⇒ BSSCOMMERCE ⇒ Google XML Sitemap.
- Step 2: Create a new XML sitemap at Marketing ⇒ Google XML.
First, we will show you how to configure the feature settings.
1.3.1. General Setting
In Enables: Choose Yes to generate an XML Sitemap.
In Frequency: Choose the frequency for the extension to update the sitemap. The options are Daily - Weekly – Monthly.
In Error Email Recipient: Choose the recipient to receive an error email once there is an error.
In Error Email Sender: Choose the name of the sender displayed in the error email.
In Error Email Template: Choose the template for error email.
In Root Path: Specify a root path for the XML sitemap.
In Sitemap Title: Enter a title for the sitemap.
In Sitemap Description: Enter a description for the sitemap.
1.3.2. Homepage Options
In Show Homepage: Choose Yes to show homepage in the XML sitemap, otherwise choose No to hide it.
In Frequency: Choose the frequency for the search engine crawlers to index Homepage. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - Never.
In Priority: Choose the priority for the search engine crawlers to index Homepage. Valid values range from 0.0 to 1.0.
In Enable Modify: Choose Yes to show the time of the latest modify of the homepage in XML sitemap file, otherwise choose No to hide it.
1.3.3. Categories Options
In Frequency: Choose the frequency for the search engine crawlers to index category pages. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - Never.
In Priority: Choose the priority for the search engine crawlers to index category pages. Valid values range from 0.0 to 1.0.
In Disable Category and All Products on Category: Fill in the ID of categories you want to hide from sitemap (separated by a comma). All products in selected categories will be hidden as well.
* Note: You can exclude categories from the XML sitemap by configuring it in each category edit page. Once you set Yes for this configuration, the category is listed in the Disable Category and All Products on Category config.
1.3.4. Product Options
In Enable Path: If you choose Yes, the Use Categories Path for Product URLs config is also enabled. This config is found by going to Stores ⇒ Configuration ⇒ Catalog ⇒ Catalog⇒ Search Engine Optimization ⇒ Use Categories Path for Product URLs.
In Frequency: Choose the frequency for the search engine crawlers to index product pages. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - Never.
In Priority: Choose the priority for the search engine crawlers to index product pages. Valid values range from 0.0 to 1.0.
In Add Images to Sitemap: Choose how you want to add the images of products into your XML sitemap. There are 3 options:
- No: Do not add images to the sitemap.
- Base Only: Only add base images of products into the sitemap.
- All: Add all images of products into the sitemap.
In Disable Product Type: You can choose to hide all products belong to (a) product type(s) from the sitemap.
In Disable Product: Fill in the ID of products you want to hide from sitemap (separated by a comma).
* Note: You can exclude products from the XML sitemap by configuring it in each product edit page. Once you set Yes for this configuration, the product is also listed in the Disable Products config.
1.3.5. CMS Page Options
In Frequency: Choose the frequency for the search engine crawlers to index CMS pages. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - Never.
In Priority: Choose the priority for the search engine crawlers to index product pages. Valid values range from 0.0 to 1.0.
In Disable CMS Link: Choose CMS links to be disabled from the XML Sitemap.
1.3.6. Additional Link List
In Frequency: Choose the frequency for the search engine crawlers to index additional links. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - Never.
In Priority: Choose the priority for the search engine crawlers to index additional links. Valid values range from 0.0 to 1.0.
In List of Additional Links: Fill in the list of additional links to be shown in the sitemap.
1.3.7. Sitemap File Limit
In Divide Sitemap: There are 4 options for dividing sitemap:
- None: Do not divide sitemap.
- Date: Divide site map by the last modified date of the products.
- Category: Divide site map by the products in the same category.
- Manufacture: Divide site map by the products with the same manufacturer. The sitemaps are arranged based on the following sort order:
1: CMS Page Link + Category Link
2: Product Link
3: Additional Link
* Note: Dividing the sitemap still follows the maximum number of URLs per file and maximum file size settings.
In Maximum No of URLs per file: Maximum number of URLs in an XML sitemap file.
In Maximum File Size: Maximum file size in byte.
1.3.8. Search Engine Submission Settings
In Enable Submission to Robots.txt: Choose Yes to display XML Sitemap URL in Robots.txt file, otherwise choose No.
1.3.9. Generate Sitemap
After finishing setting up the extension, the admins will generate a sitemap that will be created following the above settings.
Please go to Marketing ⇒ Google XML Sitemap, select Add Sitemap to create a new sitemap.
In File Name: Choose a name for the sitemap. The format is nameofthesitemap.xml.
In case you are already using an XML sitemap, there would be 2 options at this point:
- Create a new sitemap with a different name from the old sitemap. You can submit both sitemaps on Google Search Console and the crawler will read both file.
- Delete the old sitemap then create a new one with the same name as the old. The new sitemap following the module setting will be overwritten on the search console and will not affect SEO.
In Path: The default path is “/”. If you want to use a different path, you have to create a new folder at the backend.
Choose Save.
After saving the sitemap, click Generate for the sitemap to be created following the module settings.
1.3.10. Edit and Delete Sitemap
Please go to Marketing ⇒ Google XML Sitemap, select the sitemap you want to edit or delete.
In the Name, Path and Store View section, you can change the name, path and store view of the XML Sitemap. Click Save and Generate to finish the change.
Click Delete to delete the sitemap.
To reset the sitemap, click Reset and then click Save. Back to the main section, and click Generate to finish.
1.4. In HTML Sitemap
1.4.1. General
In Enable: Choose Yes to enable the feature, otherwise, choose No.
In HTML Sitemap URL Key: Enter a URL key for the sitemap.
*Note:
- URLs of the sitemap are different per store:
For example, the URL key of the sitemap in store A is store-a and the URL key of the sitemap in store B is store-b. When customers access the sitemap of store A, then switch to store B, customers are redirected to the sitemap in store B under the right sitemap URL of store B.
- Enter special characters to URL key or any spaces:
After saving configs, these special characters or spaces are auto removed and replaced by the dash(-).
In Title of Site: Choose the title for the sitemap.
In Show Link at: Select Footer or Header where the sitemap link is displayed.
In Session Order: Fill in the order of sessions to be displayed. Please fill in all 4 items separated by a coma. The ID of sessions as below:
- 1: Product List
- 2: Store View List
- 3: Additional Link List
- 4: Category and CMS Page List
1.4.2. Search Engine Optimization
In Meta Title: Choose the meta title for your sitemap.
In Meta Keywords: Choose the meta keywords for your sitemap.
In Meta Description: Write meta description for your sitemap.
1.4.3. Product List
In Show Product Link: Choose Yes to show product links in the sitemap, otherwise, choose No.
In Title of “Product List”: Choose the title for the product list session in the sitemap.
In Sort Product by: Choose among DESC for descending or ASC for ascending.
In Arrange Product by: Choose Name/Date/Price to sort product links.
In Maximum Products Displayed on Sitemap: Choose the maximum for the number of product links to be shown. The limit number you can fill in is 50000.
* Note: You can exclude products from the HTML sitemap by configuring it in each product edit page.
1.4.4. Store List
In Show Store View Link: Choose Yes to show store view links in the sitemap, otherwise choose No.
In Title of “Store View List”: Choose the title for the store view list session in the sitemap.
1.4.5. Category List
In Show Category Link: Choose Yes to show category links in the sitemap, otherwise choose No.
In Title of “Category List”: Choose the title for the category list session in the sitemap.
In Disable Category: Fill in IDs of categories you want to hide in the sitemap (separated by a comma). For example: 1,2,5,9,23,45,77.
* Note: You can exclude categories from the HTML sitemap by configuring it in each category edit page. Once you set Yes for this configuration, the category is listed in the Disable Category config.
1.4.6. Additional Link List
In Title of “Additional Link List”: Choose the title for the additional link list session in the sitemap.
In List of Additional Links: Choose the links and the anchor you want to display for each link. Follow this example: [http://yourlink1.com][Anchor Text 1].
In Open Additional Link in a New Tab: Choose Yes to open additional links in a new tab, otherwise choose No.
1.4.7. CMS Link List
In Show CMS Link: Choose Yes to show CMS links in the sitemap, otherwise choose No.
In Title of “CMS List”: Choose the title for the CMS link list session in the sitemap.
In Disable CMS Link: Choose the CMS links you want to hide from the sitemap. Hold Ctrl when choosing multiple options.
1.5. Robots Meta Tag
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Robots Meta Tag: Enter URL Pattern based on the following formats.
- With single Category Page or Product Page: enter the URL key. For example: your product page URL is http://yourdomain.com/teton-pullover-hoodie.html. Then URL key is teton-pullover-hoodie.
- With categories or a folder: Enter the path with "/" before and after the path
For example: You want to set NoIndex and Nofollow for all categories with the "tops-men" URL key. Please enter: /tops-men/
In Option: There are 3 options for you to choose, which is INDEX, NO FOLLOW – NOINDEX, FOLLOW and NOINDEX, NOFOLLOW.
In NOINDEX, FOLLOW Robots Meta Header: Choose pages to set up No Index, Follow Tag.
Edit custom instruction of robots.txt File: enter your custom instruction of robot.txt file (if any). You can learn how to write a robot.txt file here. If you leave this field blank, file Robots.txt will run with the default Magento setup.
1.6. Canonical Tag
In Enable: Choose Yes to enable the feature or choose No to disable it.
1.6.1. Canonical Tag for Homepage
In Use Another Url for Homepage: Leave it blank if you want to use the default Canonical Tag for Homepage. Fill in the URL path if you want the crawler to read that URL instead of the homepage.
This config is also included in the Search Engine Optimization section of the Homepage edit page.
1.6.2. Canonical Tag for Product
In Canonical for Product: There are 2 available options:
- Use Short Url Path: Set the Canonical Tag on the shortest product URL. Here is an example: http://yourdomain.com/product.html
- Use Long Url Path: Set the Canonical Tag on the longest product URL. If the product belongs to multiple categories at the same category level, the applied category will be the last category in the Categories section on Catalog management of the product. Take the below image as an example, the applied category will be Jackets.
In the Search Engine Optimization section of each product edit page, you can also specify another URL for the Canonical tag.
1.6.3. Canonical Tag for Category
In Use Next/Previous Tag in Category: Choose Yes to enable canonical for Next/Previous Tag in categories or choose No to disable it.
In Add Canonical Tag to Layered Navigation:
- Choose Yes: Canonical URL is the URL of the original category.
- Choose No: Canonical URL is the URL corresponding to parameters.
In the Search Engine Optimization section of each category edit page, you can also specify another URL for the Canonical tag.
1.7. Advanced Breadcrumbs SEO
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Type of Breadcrumbs: There are 2 available options:
- Use Long Url Path: Set the breadcrumbs to be the FULL path of a product or a category
- Use Short Url Path: Set the breadcrumbs to be the SHORTENED path of a product or a category. Now, you need to configure Enable Category Priority to show the shortened path (Noted: Type of Breadcrumbs config has higher priority than Enable Category Priority config.)
The Breadcrumbs for Product A will be Home ⇒ Jacket ⇒ Product A. You can take a look at the image below.
If the product belongs to multiple categories with the same category level, the applied category will be the last category at the Categories section on Catalog management of the product.
In Enable Category Priority: Choose Yes to enable category priority or No to disable it.
To manage category priority, please go to Marketing ⇒ BSS Commerce SEO ⇒ Advanced Breadcrumbs.
- ID: show the ID of the category. In this section, all available categories of your site will be listed.
- Path: show the path of the category.
- Level: show the category level. Only categories whose the category level is greater or equal 2 can be applied breadcrumbs
- Priority: fill in the ID of the prior category (to prevent your breadcrumb from rendering wrongly, you shouldn't fill the Priority ID with 1 or 2 - any other number is fine.) Take a category with ID= 5 and the path of 1/2/3/5 as an example. If you fill in the priority as 3, Breadcrumbs of category 5 and all of its belonging products will be displayed with breadcrumbs of category 3 as the priority.
- The default table has no priority set up and the system will automatically show the full breadcrumb path accordingly. Once you edit the value of the priority config, you must enter a number or Cancel to get back to the original value. From here, you can't leave this field empty anymore.
1.8. Redirect 301 SEO
1.8.1. General
In Enable: Choose Yes to enable the feature or choose No to disable it.
1.8.2. Redirect 301 SEO
This setting only applies to deleted product pages.
Here are examples of deleted product links:
In Default Redirect to: Set the default page for the 301 pages to be redirected to. These are the options for the destination of redirecting: Parent Category, Parent Category with Priority, Homepage, and Other CMS Pages.
- In case of choosing Parent Category, when a product is deleted, the links of that product will be redirected to the nearest parent category of the product.
- In case of choosing Parent Category with Priority, redirects work similarly to the option of Parent Category. However, if the destination category is set up for a priority in ID in Marketing ⇒ BSS Commerce SEO ⇒ Advanced Breadcrumbs, the links of that product will be redirected to this category priority.
- In case the product gets several categories at the same level, the category will be redirected is the last category in the Categories section on Catalog management of the product.
In Time Period (in days) to Keep Redirect on Website: choose the time period for redirecting to be applied.
1.9. HREFLANG Tag Support
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Add HREFLANG for Store View: Assign language and country for each store view.
In Enable for Homepage: Choose Yes to enable Hreflang tag for Homepage or choose No to disable it.
In Enable for Category: Choose Yes to enable Hreflang tag for Category Pages or choose No to disable it.
In Enable for CMS Page: Choose Yes to enable Hreflang tag for CMS Pages or choose No to disable it.
In Enable for Product Page: Choose Yes to enable Hreflang tag for Product Pages or choose No to disable it.
1.10. Meta Tags Template
1.10.1. Feature Settings
In Enable, choose Yes to enable the feature or choose No to disable it.
In Product Setting:
- In Max Product Meta Title Length: Choose the maximum number of characters for product meta title (should be about 70-71 characters).
- In Max Product Meta Description Length: Choose the maximum number of characters for product meta description (should be about 160 characters).
- In Max Product Meta Keywords: Choose the maximum number of product meta keywords (should be about 30 words).
- In Max URL Key Length: Choose the maximum number of characters for product URL keys (should be about 70 words).
In Category Setting:
- In Max Category Meta Title Length: Choose the maximum number of characters for category meta title (should be about 70-71 characters).
- In Max Category Meta Description Length: Choose the maximum number of characters for category meta description (should be about 160 characters).
- In Max Category Meta Keywords: Choose the maximum number of category meta keywords (should be about 30 words).
- In Max URL Key Length: Choose the maximum number of characters for category URL keys (should be about 70 words).
1.10.2. Generate a Product Meta Template
Please go to Marketing ⇒ BSS Commerce SEO ⇒ Meta Template and start configuration.
Choose Add New to create a new meta template.
In General:
- In Enable: Choose Yes to enable the template or No to disable it.
- In Name: Choose a name for the template.
- In Meta Template Type: Choose Product.
- In Scope: Choose the scope (store view, website) to apply the template. You can choose multiple store views/websites by holding Ctrl and click.
- In Priority, choose priority for the template. In case the product is under multiple categories with different templates, the priority settings will be considered for the affected meta template to avoid conflict. The smaller number will be prioritized.
In Product Conditions:
You need to set up necessary conditions to determine which products to be applied by the meta tag template.
In Template Settings:
- In Meta Title: Write the meta title for products. You can click on Insert Template Variables to choose the variables we provide.
- In Meta Description: Write the meta description for products. You can click on Insert Template Variables to choose the variables we provide.
- In Meta Keyword: Write the meta keywords for products. You can click on Insert Template Variables to choose the variables we provide.
- In URL Key: Enter a URL key or click on Insert Template Variables to choose the variables we provide.
- In Short Description: Write a short description of the products. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.
- In Description: Write a short description of the products. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.
Finally, you click Save and Generate button and then are redirected to a new Generate Meta Template page. You continue to click Start Generating button and will track the process of generating the product template. You can let the process automatically run and continue to make other configurations in a new tab. Don’t configure on the same tab while the process is happening.
After this process is finished, you can check the results on the Search Engine Optimization of each product edit page.
*Note: In the Search Engine Optimization of each product edit page, you can exclude the product from Meta Templates Updates.
1.10.3. Generate a Category Meta Template
Please go to Marketing ⇒ BSS Commerce SEO ⇒ Meta Template.
Choose Add New to create a new meta template.
In General:
- In Enable: Choose Yes to enable the template or No to disable it.
- In Name: Choose a name for the template.
- In Meta Template Type: Choose Category
- In Scope: Choose the scope (store view, website) to apply the template. You can choose multiple store view/website by hold Ctrl and click.
- In Priority choose priority for the template. In case the category is under multiple categories with different templates, the priority settings will be considered for the affected meta template to avoid conflict. The smaller number will be prioritized.
In Category Choose:
- Choose the category to apply the template. You can choose multiple categories by holding Ctrl and click.
- In Apply for Sub-categories: Choose Yes to apply the template for sub-categories, otherwise choose No.
In Template Settings:
- In Meta Title: Write the meta title for categories. You can click on Insert Template Variables to choose the variables we provide.
- In Meta Description: Write the meta description for categories. You can click on Insert Template Variables to choose the variables we provide.
- In Meta Keyword: Write the meta keywords for categories. You can click on Insert Template Variables to choose the variables we provide.
- In URL Key: Enter a URL key or click on Insert Template Variables to choose the variables we provide.
- In Description: Write a short description for the categories. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.
Lastly, click Save and Generate and do similarly as you start generating the product meta template.
*Note: In the Search Engine Optimization of each category page, you can exclude the category from Meta Templates Updates.
1.11. SEO ALT Text
1.11.1. Configurations
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Alt Tag Template: Write Alt text template for images. You can click on Insert Template Variables to choose the variables we provide.
In Image Name Template: Write the name template for images. You can click on Insert Template Variables to choose the variables we provide.
Then you click Generate button to be redirected to a new page, then start generating both templates. You can track the process in this page conveniently.
*Note: In the Search Engine Optimization of each product edit page, you can exclude the product from SEO Alt Text Template.
1.11.2. Manage images and edit ALT for each image
Please go to Marketing ⇒ BSS Commerce SEO ⇒ SEO ALt Text.
This grid shows all product images on your website and you can easily filter wanted images.
When you click an image, you are able to edit the image file name and alt text, then save config within the grid.
*Note: Enter the right format for image names without any special characters and under .jpg, .jpeg, .png, .gif, .bmp.
For product with many images, click on the product and every image is shown for you to edit.
1.12. SEO External Links
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Excluded Domain: List domains you want to not apply this function.
1.13. SEO Toolbar
In Enable: Choose Yes to enable the feature or choose No to disable it.
Then you click Start Check button to see an SEO analysis for homepage on the frontend.
This toolbar tells you which SEO factors meet requirements, and which ones are not good enough and need to be checked again.
When you navigate to other pages, the toolbar appears to give an SEO analysis for these pages.
1.14. SEO Report
2.14.1. Configurations
In Enable: Choose Yes to enable the feature or choose No to disable it.
In Google Search Console Start Date: Enter a start date to check data on Google Search Console.
In Google Search Console End Date: Select an end date
- Current date: Data is checked from the start date to the current time you are checking.
- Custom date: You can select any date as you want.
In Google Authorization Code: Click the button to get the Google Authorization Code, then enter it into the field.
1.14.2. SEO report & SEO Audit in edit pages
After completing configurations, you navigate to a product, category or CMS edit page to check how SEO report and SEO Audit performs.
- SEO Report
In Meta Title and Meta Description: display a color bar to notify admins about how valid title and description are, according to the number of characters.
In Main Keyword: Enter the main keyword and it is used to for SEO Audit and Google Search Console.
- SEO Audit
In SEO Audit: The module gives you a list of messages to notify about:
+ The usage of main keyword in meta title, meta description, product description, and URL
+ Main keyword density
+ The current situation of description
+ Outbound links
In Google Search Console: You need to set up Google Authorization Code to connect Google Search Console, then complete settings in the SEO Report Config.
A grid is displayed to tell you such information as below:
The module checks 3 factors in this section: Main keyword, Meta keyword and Page URL. Through connecting Google Search Console, the admin will know the details of each key including Average position, Impressions, Clicks and CTR.
*Note: URLs of product, category or CMS pages are used to query on Google Search Console. These URLs meet configs on the Canonical Tag module.
1.14.3. SEO Report Dashboard
Please go to Marketing ⇒ BSS Commerce SEO ⇒ SEO Report.
This grid displays all important SEO information of page URLs on the website.
If you click Crawl All Site button, you are redirected to the Crawl SEO report page. The module carries out crawling data for websites which have just set up this module. This process only needs to be done once because new products are automatically updated.
You tap Crawl All site button to start the data crawling process. There are 2 Crawl status:
- Success: the URL can be accessed from the frontend (even 404).
- False: Lost of Internet connection can be a cause for False status. As a consequence, the crawling process is not finished.
*Note:
- Data of meta title, meta description, meta keyword and main keyword is updated according to the real time.
- Data of Headings, Images, Open Graph, Twitter Card is updated once a day when admins edit products/categories.
- During the crawling process, you can open a new tab to make other configurations.
- The process will stop when you click Back to SEO Report button.
Pop-up for Magento 2 extension helps you create the eye-catching pop-up that is highly flexible and customizable for many purposes, such as promotion, notification, guideline, or newsletter. You decide where to display the pop-up, set display animation, and apply for customer groups or store views.
II. Magneto 2 Popup
2.1 General Configuration
Please go to Stores ⇒ Configuration ⇒ BSSCommerce ⇒ Pop-up General Configuration.
In Enable, choose Yes to enable the extension, or No to disable it.
2.2 Manage Pop-up Grid
Go to Marketing ⇒ BSSCommerce ⇒ Pop-up ⇒ Manage Pop-up.
Manage Pop-up grid shows all pop-up you have created with full information, including Pop-up Name, Enable, Display Rule, Displayed Pages, Content, Store Views, Customer Groups, Start Date and End Date. The Manage Pop-up grid works just like standard grid in Magento 2 default with features such as mass action (delete, enable, disable), filter and column display.
2.3 How to Create New Pop-up
Please click on the Create New Pop-up button located on the top right of the grid. You will be redirected to the New Pop-up Page, which has 3 tabs:
- General
- Display Rule
- Content and Design
There are 4 buttons to support creating a new pop-up:
- Back
- Reset
- Save and Continue
- Save Pop-up
2.3.1 General
In Enable, choose Yes to enable the new pop-up.
In Name, enter the pop-up’s name.
In Store Views, select which store views to display the pop-up.
In Customer Groups, choose the customer groups to view pop-up.
In Start Date, select a date in the calendar view to begin showing the pop-up.
In End Date, select a date in the calendar view to stop displaying the pop-up.
In Priority, enter a number to decide the priority of the pop-up when multiple pop-ups are created on a page.
2.3.2 Display Rule
In Display Rule, choose one of the four following conditions to set conditions for displaying the pop-up:
- After customers spend X seconds on the page.
- After customers scroll page by X percent.
- After customers view X pages.
- Immediately when customers visit the page.
In X equals, enter a number to decide the value of X.
In Display Animation, choose one of the six following options to set display effects for the pop-up:
- Zoom
- Horizontal Move
- Move from Top
- 3D Unfold
- Zoom-out
- None
In Position, select the position to display the pop-up on the page.
- Top Left
- Top Center
- Top Right
- Middle Left
- Middle Center
- Middle Right
In Auto Close Pop-up After, enter the amount of time (seconds) for the pop-up to automatically close. Ex: 10. Enter “0” to disable auto close of Pop-up
In Display Frequency, determine the frequency of pop-up display by selecting one of the following options:
- When all conditions are satisfied: the pop-up appears if the above rules are executed.
- Only once: the pop-up only appears once.
- Only once per session: the pop-up appears once in a session. If you choose this option, you need to set Cookie Expires.
For example, if you choose Display Frequency as “Only once per session” and set the 2 minutes for the Cookie Expires, the pop-up is displayed when the conditions are satisfied, then it won’t be shown in the next 2 minutes (until the session ends or the cookie expires).
In Layout Updates:
In Display on, select pages to show the pop-up, including the following types of pages:
- Category Pages
- Product Pages
- Generic Pages
When you choose each type of page, you can select all pages or specific pages depending on your demand.
For example:
+ Category page:
+ Product page:
+ All pages:
(you can exclude specific pages from displaying a popup when you select the option as All pages)
Furthermore, it is easy to add more layout updates to show popup in more pages by clicking the button.
2.3.3. Content and Design
In Content, use the WYSIWYG editor to create content for the pop-up.
You can use this tool to insert widget, image or video for the pop-up’s content.
In Pop-up CSS, use CSS to change the design of the pop-up. If leaving blank, the default pop-up will be applied.
Or, you can use our default template to quickly render your pop up.
There are 5 templates to choose from:
- Contact Form
- Age Verification
- Newsletter
- Hot deals (product listing)
- Social sharing
After choosing your template, click on the Load Template button to make the template appear in the Content edit interface.
In the Content edit, you can make any modification if needed.
Note: After any change to the pop-up configuration, either Save, Delete, Mass delete, Mass active, is made, a cache notification will appear.
You then must go to SYSTEM -> Tools -> Cache Management ->Flush Magento Cache for those changes to be applied to the front end.
III. Magento 2 One Step Checkout
Please go to Stores ⇒ Configuration ⇒ BSSCOMMERCE ⇒ One Step Checkout.
3.1 In General
In Enable:
- Choose Yes to enable Magento 2 One Step Checkout extension.
- Choose No to disable this module.
In Allow Creating Account On Checkout Page:
- Choose Yes to allow customers to create their accounts right on the checkout page.
- Choose No to disable this function.
In Title: Write your wanted title for the checkout page.
In Router Name: Choose an URL name for your checkout page.
3.2 In Fields Display
In Show Order Comment:
- Choose Yes to show a text box for customers to leave their comments for orders.
- Choose No to exclude this box from the checkout page
In Show Discount Code:
- Choose Yes to display a discount code box for entering coupon codes.
- Choose No to hide it.
3.3 In Newsletter
In Show Subscribe Newsletter:
- Choose Yes to allow customers to subscribe to the newsletter on the checkout page.
- Choose No to disable this function.
In Auto Check Newsletter Sign up Box: Choose Yes to automatically tick the Newsletter Sign up box or choose No to uncheck.
3.4 In Tracking Address by Google
In Enable Tracking Address by Google:
- Choose Yes: Auto-detect and pre-fill customers' country, state/province, city - Google Suggest to autocomplete shipping address while typing.
- Choose No: Customers have to find all street addresses and location information themselves.
In Google API Key: Fill in your API Key. In case you haven’t yet had an API Key, please click the link after this configuration to get it.
In Tracking Address from Applicable Countries: This configuration determines which countries to apply auto-suggesting customer addresses. There are 2 options to select:
- If you choose All Allowed Countries: auto-suggesting address function is applied to every country.
- If you choose Specific Countries: there is a list of countries in Tracking Address from Specific Countries and the maximum number of countries you can select is 5. Moreover, when you choose this option, Google just auto-suggests city name and country, not street name. This is the default function of Google auto-suggest.
*Notes:
- Admin has to work with Google and pay for Google Maps to activate the address autocompleting feature.
- Your websites must be "https://" to run the auto-fill function.
- Your login customers can checkout with multiple addresses.
3.5 In Order Delivery Date
In Show Delivery Date:
- Choose Yes to display Order delivery date in the Shipping method section that allows customers to choose their own suitable dates and times to receive orders.
- Choose No to disable this function.
In Show Delivery Comment:
- Choose Yes to display a Delivery comment box in the Shipping Method section.
- Choose No to hide it.
*Install M2 Order Delivery Date to see more premium features of this function:
- In case M2 Order Delivery Date is installed: All features of M2 Order Delivery Date will be active. Customers can choose the delivery date and admin can give them certain delivery time slots:
- In case M2 Order Delivery Date is not installed: All features of One Step Checkout delivery date will be active. Customers can choose whatever delivery date and time they want:
3.6 In Gift Message
In Show Gift Message on Order Level:
- Choose Yes to allow customers to send a gift message to other people.
- Choose No to disable this function.
* Gift Message config is applied only when the corresponding default config is enabled. To enable the default config, please go to Stores ⇒ Sales ⇒ Sales ⇒ Gift Options and choose Yes to the suitable gift message level:
3.7 In Gift Wrap
In Enable:
- Choose Yes to allow customers to request a gift wrap for their order.
- Choose No to disable this function.
In Type: This function currently supports gift wrap for each order only, so the value is Per Order by default.
In Gift Wrap Fee: Fill the price for gift wrap service. The entered value is a positive number and automatically rounded to two decimal places. If left empty or filled with a negative number, the value would turn to be 0.
3.8 Additional Add-on
M2 One Step Checkout is already compatible with multiple related modules: M2 Customer Attributes, M2 Checkout Custom Field, M2 Reward Points, M2 Pre-Select Shipping/Payment. Install the suitable modules to better optimize M2 One Step Checkout.
- M2 Customer Attributes: Carefully config the Customer Attributes function to give your customers the best shopping experience! Go to Customers ⇒ Customer Attributes. In each customer attribute, go to Display Configuration:
- In Display on Checkout Page: Choose Yes to make customer attributes be shown on the checkout page, choose No to disable this function.
- In Hide If Filled Before: Choose Yes so that if customers fill the customer attribute for the first time, it will not display after that. Choose No to always display the customer attribute whenever customers go to the checkout page.
- M2 Checkout Custom Field: Go to Sales ⇒ Bss Commerce ⇒ Manage Checkout Custom Field ⇒ Add New Field to create a custom field for the checkout page.
- M2 Pre-select Shipping/Payment: Go to Stores ⇒ Configuration ⇒ BSS COMMERCE ⇒ Pre-select Shipping/Payment to config the default shipping/payment method when customers enter the checkout page.
3.9 In Custom Style
In Checkout Step Number Color: you choose the color for the checkout number steps.
In Checkout Step Background Color: Choose a color for the background of checkout number steps.
In Custom Code: you can add more code to customize about background color for the checkout page, “Sign in” button or text color and so on.
3.10 Somes notes
- Notes about custom code
+ Change background of the checkout page, you need to add more code:
body { background-color: #333333;
}
(#33333 is the color code which is corresponding to Black).
+ Change text color of the checkout page, you need to add more code:
body { color: #ffffff;
}
(#fffff is the color code which is corresponding to White).
+ Change Sign in to a button, you add more code:
.authentication-wrapper button{
padding: 15px;
background: #6D268A;
color: #fff;
}
.authentication-wrapper button:hover{
text-decoration: unset;
background: #FF0000;
color: #fff;
}
- Note about configuring payment method
+ You need to configure all payment methods that default Magento supports.
+ Current support payment methods:
- Amazon Payment
- Paypal, Paypal Braintree, Paypal Express Checkout, Paypal Payflow Pro & PayPal Payment Flow CreditCard
- Pay by Credit Eway
- Splitit Card-Based Installment Payment Solutions
- NMI payment Direct Post
- NEW! Sagepay payment (Ebizmarts_SagePaySuite
- Zalopay
- Pay by Card (Stripe), Credit Card
- Online banking, etc.
- Stripe official
- Note about adding payment trust badge
Step 1: Go to Content ⇒ Blocks ⇒ Add New Block to create a new block for payment trust badge.
Step 2: Go to Content ⇒ Widgets ⇒ Add Widget to choose certain place to display the block of payment trust badge.
- Note about adding header/footer for the checkout page: Upload folder bss_onestepcheckout to app/design/frontend/theme_space/theme.
3.11 API Support
We provide you lists of Restful API and GraphQL API that our Magento 2 One Step Checkout extension supports.
*Note:
- Restful API support is included in the main module package (from One Step Checkout v2.1.9).
- GraphQL API support is included in the GraphQL package, acting as an add-on for anyone who needs to use GraphQL.
3.11.1 Restful API
| No | API | URL | Method |
| 1 | Update cart information in One Step checkout when customers change product quantity (for Not logged-in customers) | {{base_url}}/rest/V1/bss-osc/guest-carts/:cartId/update-item | POST |
| 2 | Update cart information in One step checkout when customers change product quantity (for logged-in customers) | {{base_url}}/rest/V1/bss-osc/carts/mine/update-item | POST |
| 3 | Apply Gift Wrap | {{base_url}}/rest/V1/bss-osc/giftwrap/apply/0 | POST |
| 4 | Validate Gift Wrap | http://one-step-checkout.demom2.bsscommerce.com/rest/V1/bss-osc/giftwrap/validate/:fee/:use | POST |
| 5 | Add information about Order delivery date and delivery comment to orders when getting orders via /V1/orders/:id (default) | {{base_url}}/rest/V1/orders/:id | GET |
| 6 | Add information about Order delivery date and delivery comment to invoices when getting invoices via /V1/invoices/:id (default) | {{base_url}}/rest//V1/invoices/:id | GET |
| 7 | Add information about Order delivery date and delivery comment to credit memo when getting credit memo via /V1/creditmemos/:id (default) | {{base_url}}/rest/V1/creditmemos/:id | GET |
| 8 | Add information about Order delivery date and delivery comment to shipment when getting shipment via /V1/shipment/:id (default) | {{base_url}}/rest/V1/shipment/:id | GET |
| 9 | Get Store config of the module | {{base_url}}/rest/V1/bsscommerce/osc/storeconfigs/:storeview | GET |
| 10 | Add information about Order delivery date and delivery comment to the payment extension corresponding to the customer's current cart | {{base_url}}/rest/V1/bsscommerce/osc/deliveryinfo | PUT |
| 10.1 | Add information about Order delivery date and delivery comment to the payment extension by GUEST | {{ api_base }}/V1/bsscommerce/osc/deliveryinfoguest | PUT |
| 11 | Get information about Order delivery date and delivery comment from Quote | {{base_url}}/rest/V1/bsscommerce/osc/deliveryinfo/cart/:id | GET |
3.11.2. GraphQL API
| No | GraphQL API | URLs | Method |
| 1 | Add information about Order delivery date and delivery comment to orders when getting orders via customerOrders default | {{base_url}}/graphql | POST |
| 2 | Add information about Order delivery date and delivery comment to the payment extension | {{base_url}}/graphql | POST |
| 3 | Get information about Order delivery date and delivery comment from Quote | {{base_url}}/graphql | POST |
IV. Magento 2 Guest To Customer
To configure the extension, please go to Store ⇒ Configuration ⇒ BSSCOMMERCE ⇒ Guest to Customer.
4.1 General configs
In Enabled: set Yes to enable or set No to the module.
In Assign Orders with The Same Checkout Email to Customer: Choose Yes to enable this function and choose No to disable it. The logic of this config is presented as follow:
| Config status | Customer behaviors | Result |
| Yes | Create an account right after the purchase using this button on the checkout success page: | The order gets assigned to the customer profile both frontend and backend. |
| Yes | Create an account using after the purchase using the button on the header: | Due to complications regarding time delay between orders and the relation with the invoice, credit memo,... outside of a sheer order => Currently, in this case, the extension doesn't support assigning orders with the same email to the new account. |
| Yes | Checkout using the registered email but not login | The order gets assigned to the customer profile both frontend and backend |
- Config: Yes. The customer creates an account right after their purchase using the button => The orders get assigned to the customer profile both frontend and backend.
- Config: Yes.
In Sync address, choose Yes to synchronize customer's address when the billing address and shipping address are the same.
In Auto Convert to Customer: there are 2 options to select.
+ If you set Yes, guests are automatically converted to real customers after they finish their checkout.
In Customer Group: select customer group to assign converted customers.
+ If you set No, guest users after checkout will be included in a Guest Management grid table. Then, you can make mass actions to assign them to customer groups. This action also means that you manually convert them to real customers and create accounts for them.
For guests placing orders before you install this extension, you can still import them to the Guest Management grid, and convert them into customers automatically or manually.
Accordingly, pick a period time to import guest in From and To.
Then, click Import button to import guests.
4.2. Guest Management
You go to Customers ⇒ Guest ⇒ Guest Management to check this table:
If you want to convert any guest to a customer, you tick in the box and then choose Assign a Customer Group. Specific customer groups are displayed to select:
After choosing customer group and submit the request by click OK in the popup, guests are converted to customers.
4.2 Notification email
In Enable Notification Email to Customer: choose Yes to enable this function or choose No to disable it.
In Email Sender: select one store email to send notification emails to customers. These emails confirm customer account information to login into store website.
In Email Templates: select email template. This extension provides a default email template and you can easily customize in Marketing ⇒ Communications ⇒ Email Templates.
4.3 Required fields
In this section, you complete customer information which are displayed in the checkout if you set up as Required for this information in the Name and Address Options.
*Note: Reason why you need these configurations.
In Stores ⇒ Configuration ⇒ Customer ⇒ Customer Configuration ⇒ Name and Address Options:
In case you set Required for information such as Show Prefix, Show Suffix, Show Date of Birth, Show Tax/VAT Number, Show Gender, Show Telephone, Show Company and Show Fax, which means that customers can create accounts only when they complete all of this information. However, when a guest user checkouts, he/she doesn't complete them because this information is not included in the default checkout. Therefore, the module cannot create accounts for guests when converting them to customers
With Required Fields configuration of the module, customer information is completed here and in the above case, the module will take customer data from these configurations to create an account for converted customers.
V. Magento 2 Social Login
Please go to Store ⇒ Configuration ⇒ BSS COMMERCE ⇒ Ajax Social Login.
5.1. General
In Enable, choose Yes to enable the extension or No to disable it.
In Use Popup Ajax, choose Yes to enable popup for login and register. Otherwise, choose No to disable it.
In Send Password, choose Yes to send customers an email that contains the password after they login using a social account. The customer then can use their email and password to log in to your site. Choose No to disable it.
In Display Customer Photo, choose Yes to display the customer’s profile photo from the social account they used for signup, or choose No to not display customer’s social photo.
In Redirect after Login, select the page on site or any particular URL you want to redirect after customer login successfully.
In Redirect after Register, select the page on site or any particular URL you want to redirect after customer completed register process.
5.2. Social Button Block
In Display buttons social login on popup, decide to display social buttons on Login tab or Register tab of popup, or place it on both tabs.
In Display buttons social follow class or id, enter class/id to place social button social login on.
In Display buttons social register follow class or id, enter class/id to place social button social register on.
In Number of button displayed, set the restriction of number of buttons to display on social login block.
In Social Button Sorting, decide the arrangement of buttons in social login block.
5.3. ReCaptcha
In Site Key and Secret Key, click “Create a site key” and register reCaptcha.
After registering, you will get the Site key and Secret key as below:
In Theme, choose the theme of reCaptcha between:
Light:
Dark:
In Type: Choose the type of robot checking between Image and Audio
In Size: Choose the size of reCaptcha widget between Normal and Compact.
In Popup Form: Choose the form(s) of popup on site to place the reCaptcha widget. A form of popup includes Login, Register and Forgot Password?
5.4. Configure specific social account
5.4.1. Facebook
Take Facebook account as the example:
In Enable, choose Yes to enable Facebook account for login and register on the site, or choose No to disable it.
In App ID and App Secret, click on “click here” below Enable dropdown box, you will be redirected to a page to set up new API like below.
After completing register step, you will see a page as below. Click on Get Started in Facebook Login.
Click on Dashboard, you will see your App ID and App Secret - copy them and paste correspondingly into App ID and App Secret box in the backend configuration.
In URI redirection valid OAuth– copy the Valid OAuth redirect URIs like below and paste into the box URI redirection valid Oauth.
In Small Icon, upload the file for the icon of this account displayed in the frontend.
In Login Button Text, customize the text in social login button.
In Registration Button Text, customize the text in social registration button.
Note: In case you run into the error “Blocked URL” use URI at the link to re-setup the configuration, as follow:
For other social accounts, follow similar steps like the setting for Facebook:
5.4.2. Twitter
5.4.3. Google
5.4.4. LinkedIn
To get Client ID, Client Secret and Redirect URL, please click on "click here" link and follow steps as below:
+ Create new application:
+ Set up Authentication for application: You get Redirect URLs in this step:
+ Copy Client ID and Client Secret to the configuration:
5.4.5. Window-Live
To get Application ID, Application Secret and Redirect URL, please click on "click here" link and follow steps as below:
+ Click on "click here" link to be redirected to Microsoft App register page:
+ Copy & Paste Redirect URL(s) to the app detail page:
+ Copy & Paste Application Id and Secret to Social Login configuration:
5.4.6. Instagram
Note: You need to edit the email after the 1st login.
To get Application ID, Application Secret and Redirect URL, please click on "click here" link and follow steps as below:
+ Create New Client ID:
+ Fill in web information:
+ Get Client ID and Client Secret:
*Note:
- Client status must be Authorized, then you can get the real Instagram account. In case you use sandbox mode, sandbox account is only accepted.
- Sometimes, you might face up to the error like this.
The solution is to copy the Redirect URIs and paste it in the client info page:
5.4.7. Vkontakte
Finally, click Save Config and to complete setting process.