Item Name is used in your Product Archive / Search Pages.
You want to keep it short but descriptive, as this is the first description a customer will see.
The character limit for this field is 255 Characters.
This description will appear on the Product Single View Page.
It gives a longer summary of what the product is about.
The character limit of this field is 500 characters.
This is used to give as much information as possible about the product.
Be careful of using this, especially when copying data from another website.
As most data from other websites are contained within HTML you are copying that HTML code over without realising it.
This could hurt both consistency on your site how this description is rendered (and even in some cases break your themes layout altogether) as well as your SEO score if the wrong Tags are used. (Especially in cases where H1, H2 or H3 tags are used)
You can also input images here but I highly discourage this.
If you are unsure the best course of action will always be the click on the "Show Source" button and then paste your data as this will paste it without HTML formatting (If you copied what looked to you like text only)
You can then click on that button again and modify the line breaks, bulleting etc.
When it comes to SEO and accessibility best practices for a WooCommerce single product page, using proper HTML heading tags (<h1>, <h2>, etc.) is important for both user experience and search engine crawling.
Here's a breakdown of how heading tags should ideally be structured on a single product page in WooCommerce:
<h1 class="product_title entry-title">Awesome T-Shirt</h1>
<h2>Description</h2> <h2>Additional Information</h2> <h2>Reviews</h2>
<h3>Material & Care</h3> <h3>Size Guide</h3>
Out of the box, WooCommerce usually wraps the product title in <h1>, and the description/review tabs are often in <h2> or <h3>, depending on the theme. But it’s theme-dependent, so always inspect the source or override templates if needed.
In Smart-IT we have Attributes (Which plays hand in hand with Web Combination Items) and we have Features.
WooCommerce only has attributes, so both the attributes and the Features from Smart-IT will pull into the attributes of WooCommerce.
Web Combination Items from Smart-IT will populate variations in WooCommerce.
Lets look at what each are in Smart-IT
Attribute
Specific properties assigned to a product, such as size and color in clothing, help customers filter and select products based on their preferences.
As mentioned earlier this goes hand in hand with Web Combination Items. I will explain later why.
Feature
Functionalities or specifications of a product that enhance its usability or appeal.
For example, a laptop might have features like battery life, processor speed, or screen resolution..
Features are used primarily for filters so we want to make conscious decisions in how many Features we load as you can only load so many filters.
The more Features you have and the more characters are used within the name and value of these filters, the slower your website response will be.
To Create a New Feature.
Click on Edit/Add Feature.
Click on Add Feature Type in the name for the Feature for example Material.
Click on Select and select out the Feature you want to add.
It will populate in the Feature table.
If an existing value needs to be used click on the dropdown Value (Existing) next to the feature and select out the value
Alternatively if its a new value you want to add type it in the Value (Freehand/Add) field next to the feature.
Attribute Name:
WooCommerce Database limit: 200 characters (WooCommerce schema: name VARCHAR(200)
)
API sanitizes long names; best to stay under 100 characters for stability.
Attribute Values:
Each term name: 200 characters
Keep practical limit to 26 characters for searchability and UI usability
Please Note: These limitations are not imposed by Smart-IT but by WooCommerce.
Technically you can update the values in phpMyAdmin
phpMyAdmin table wp_terms
Change structure and name and slug from varchar(200) to varchar(1000)
Please note any database update can possibly change this back and potentially break your site (Site might be down and say critical error in that case)
Also note this change will have a significant impact on performance
Smart-IT does not take any responsibility if you perform the steps mentioned above
When you’re adding attributes for your products, there are two ways you can add them:
Generally, it’s preferable to define attributes globally. Once global attributes are defined, they can be assigned to any products as needed. Global attributes make updates easier as well. Say your marketing team wants to start calling “Blue” products “Cerulean” instead. You just update the name once in the attributes page, and it’s updated everywhere that attribute was used.
Adding global attributes sets them up so they can be applied to any product in your store. To add an attribute globally:
If enabled, you can view a page with all products having any term of this attribute. For example, if you have this enabled, and “black” is one of the options under the “colour” attribute, you can add http://yourstore.com/color/black/ to your menu to only display items with the “black” attribute.
Now your attribute is created, you’ll need to add terms aka. the options or values
After your attributes are created and their terms defined, you can add the created attributes to your products:
Note:
When adding attribute values to a product using the “Select all” button, they will be added in their sort order. See above for details on the sort order options. The order values are added to the product here is the order they will be displayed on the front end of the site.
If you’ll only be using an attribute for one product, you can create and add it to that specific product from the “Attributes” tab on the “Edit Product” page. This would only be ideal if you have a product with unique variations. Attributes created on the product page are not available for global use.
To add a custom attribute to a single product:
In this way you can quickly add one-off attributes to products that have special characteristics.
Add custom attributes using the “Add New” button. These will only be added to this product, and will not be available for reuse on other products
Adding a variable product is similar to adding a simple product, but with a few more details to consider.
Click “Publish” in the top right of the screen to publish the product.
Recommended Resolution is 800 x 800 for Products.
You can sort attributes and attribute values of variable products to change their display in the shop’s front end. In the admin view, you can also sort product variations for ease of management. The following sections cover how to sort and organize the various details of your variable products
You can reorder both attributes and their values (variations) for the customer or storefront view from the “Attributes” tab. Here is how to do it:
In the customer’s view, the selection fields of a variable product display in the same order as you sort them in the admin area. To sort your product’s attributes:
When using custom attributes on a variable product, the values will appear in the product dropdown on the storefront in the same order that you enter them in the “values” field.
Similar to custom attributes, global attribute values appear in the same order on the product page as they do in the “Values” field of the product’s data. When created global attributes assign a defined sorting order, which determines how they populate in the “Values” field.
Note: The product page utilizes the manually sorted order only if the attribute’s default sort order is set to “Custom Ordering.”
Can be found on the Product, on the Picture and Memo Tab.
Use the Images button.
From here you can browse to an image on your PC, copy an image from your clipboard or even scan in an image.
You can add as many images as you want but remember the more images you add the more resources will be used to open this Product Page.
You can set the Order of the Image and even use the Description to describe the image (Used in WooCommerce as the Alt Image Tag)
The recommended resolution is 800 x 800 pixels, 72dpi and the image format recommended is jpg.
This will keep the images small and the viewing experience consistent.
Can be found under the Tab Stock Items, Extra, Tables, Brands.
If you previously used Brands within Smart-IT and do not see anything listed here use the Auto Create Brands Button to populate the Brands.
From here you Add or Edit a Brand .
Name would be the name of the brand.
Description would be the slogan of the brand or a description of the Brand. It is limited to 255 Characters.
Logo Image would be the brand logo.
The recommended resolution is 400 x 200 pixels, 72dpi and the image format recommended is jpg.
This will keep the images small and the viewing experience consistent.
The Items can be setup on the product page, under the Additional Info Tab using the Brand name Search button.
Alternatively you can use the Bulk Change Selected in Extended Item Lookup to apply a brand to multiple items.
Payfast Bank Ledger Account
We need to setup Payfast as a Bank on our Ledger
Click on the Ledger Tab and then on the Account Setup Icon.
Click on Add New Main Account and type the following Information:
Description: Payfast
Account Type: Bank
Default VAT: Not Applicable
Allow Post: Ticked
Reconcilable: Ticked
The account is now ready to be used.
You can allocate payments 3 different ways
Menu Generation (From Smart-IT - Use with caution as this will delete your current menu!)
On Shopify go to
Apps and sales channels > Develop Apps
Choose the App Developed by Smart-IT
Click on the Configuration Tab
Click on the Edit button next top Admin API integration
Online Store navigation
View menus for display on the storefront
Tick write_online_store_navigation
Tick read_online_store_navigation
Click on the Save button
You should now be able to use the Generate Menu button on the Shopify module within Smart-IT.
If a website is new there might have been issues when the developer initially setup the site.
This causes the variable items no pull in under its master but not correctly assigning to the desired attribute.
To fix the issue
If a website is new there might have been issues when the developer initially setup the site.
To fix the issue
Check that you can access the following page (Replace YOURURL with your domain)
https://YOURURL/wp-json/wc/v3/settings/general
Example
https://woocommerce.smartaccounting.co.za/
would be
https://woocommerce.smartaccounting.co.za/wp-json/wc/v3/settings/general
If you get an error 443 error (as shown below) then your hosting provider needs to open the Port or make changes in the Firewall.
Not Found
The requested URL was not found on this server.
________________________________________
Apache Server at YOURURL Port 443
When you get an 401 error (as shown below) then you know you are on the right track and can retry Syncing from Smart-IT.
{"code":"woocommerce_rest_cannot_view","message":"Sorry, you cannot list resources.","data":{"status":401}}