Getting started
Overview
Definitivo Commerce Studio is a free plugin for WordPress and WooCommerce. It adds thirteen blocks to the block editor, made to sell the products of a store, and whole landing pages built with them.
What every block has in common:
Drawn by the server
The page works without JavaScript; the script of a block only improves what the page already does.
The colors of your theme
A block follows the theme until you choose other colors, and has a light and a dark color scheme.
Its content in the sidebar
You write texts, choose photos and set styles in the sidebar of the editor. The canvas shows the block as the site will draw it.
A panel for each element
The title, the text, the buttons and every other element have their own panel in the Styles tab, with color, size, alignment and corner radius.
Accessibility
The blocks follow the WCAG 2.2 as a reference: they are used with the keyboard, read by screen readers, and their default colors are checked for contrast.
Getting started
Requirements
| Component | Minimum version |
|---|---|
| WordPress | 7.0 |
| WooCommerce | 11.0 |
| PHP | 7.4 |
WooCommerce must be active: the plugin is not activated without it. The plugin is made for block themes and works with classic ones.
Getting started
Installation
- Install and activate WooCommerce.
- In Plugins > Add New Plugin, search for “Definitivo Commerce Studio”, install it and activate it. You can also upload the ZIP file in Plugins > Add New Plugin > Upload Plugin.
- Open a page in the block editor.
From there you have two ways to start:
A whole landing page
Click the button Definitivo Commerce Studio in the top bar of the editor, or open Commerce Studio > Landing pages in the dashboard.
One block
Open the inserter and look for the category Definitivo Commerce Studio.
How to use
Landing pages
A landing page is a whole page for one product, ready for your texts and your photos. The plugin comes with two:
- Landing Page Light
- Landing Page Dark
They are the same page in the two color schemes: a bar with links to its sections, the product at the top, its photos, its story, its details, the product point by point and beside the others, what buyers say, their questions, more products and a footer.
Creating a page from the dashboard
- Open Commerce Studio > Landing pages.
- Choose a landing page. The preview shows it with the products of your store, at the width of a computer, a tablet or a phone.
- Click Create a page with this landing page.
- Choose the product the page is about, or click Decide later.
The page is created as a draft, with the title of the landing page, and opens in the editor. Nothing is published until you publish it.
Adding a landing page to a page you are editing
- Click the button Definitivo Commerce Studio in the top bar of the editor.
- Choose a landing page and click Use this landing page.
- Choose the product, or click Decide later.
After the page is created
- Replace the sample texts. Every text of a landing page is an example that says what to write in its place. The average rating, the number of reviews and the facts about your store come empty or as placeholders: write the real ones before you publish.
- Choose the photos. A block that shows a photo and has none yet draws the place of the photo, in the editor and on the site. Choose the photo in the sidebar, or turn the photo off where the block offers that switch.
- Use a page template without header and footer. The landing page has its own bar and its own footer. Choose a template of your theme that has neither, so the page does not show two of each.
How to use
Working with the blocks
Content and styles
Select a block to see its sidebar. It has two tabs:
- Settings: the content. Texts, photos, lists, buttons and what the block shows.
- Styles: the look. The color scheme, the widths, the colors and one panel for each element.
In the blocks whose content is written by hand, the canvas is a preview: click an element in it and the sidebar opens the panel of that element. The exception is the Product Hotspots, where the points are also dragged over the photo.
Color scheme
Every block has two schemes, in the first panel of the Styles tab:
- Light: the theme as it is. This is the default.
- Dark: a dark background, light text and a light accent.
The scheme changes every element that has no color of its own. A color you choose for the block or for one element always wins.
Widths and corners
Every block has the width of the block and the width of its content:
- Block width: Full width goes from one edge of the screen to the other. Card is as wide as you say, centered.
- Content width: how wide the content is inside the block. It starts at 1280 px, and can have no limit.
- Corner roundness: none, small (8 px), medium (16 px) or large (24 px). A card starts with large corners. A block of the full width starts square; choose a corner when the block has a margin at its sides.
For the full width to reach the edges of the screen, the page needs a full-width template of the theme.
Colors
A color can be one of the palette of the theme or an exact color, from the color picker. The colors of the block are used by every element that has no color of its own.
Background image
A block can have a photo behind everything, with the part of the photo to keep in view and a color over it. You choose the color and its intensity, so the text stays readable.
The place of a photo
A block that shows a photo and has none yet draws a place for it. Visitors see what was published, so replace the place with a photo, or turn the photo off, before the page goes live. A block with nothing written draws no place.
Blocks of products
Product Hero
The product at the top of a page: its photo, its name, its price, the buttons to buy and what makes a visitor trust the purchase.
The product can be:
- one you choose;
- the product of the page the block is on (in a product template);
- chosen by the store: a featured product, or one on sale.
What it can show, each one turned on in the Settings tab:
- a label above the title;
- the title, a subtitle and a summary (the short description of the product, or a text of your own);
- the rating of the product;
- the price, with the discount of a product on sale;
- a countdown;
- up to two buttons: add to the cart, see the product, or a link of your own;
- a trust line and a social proof;
- a list of benefits and a list of guarantees.
The image can be the photo of the product or another image, and is presented in one of four ways:
| Presentation | What it does |
|---|---|
| Automatic | A photo with a transparent background is shown cut out; any other is shown in a frame. |
| Cut out | The product with no background, on a podium. |
| Framed | The photo with its background, in a frame with a shadow. |
| Fill the column | The photo takes its whole half of the block, from edge to edge. |
You can also set the size of the image, its focal point for each device, its side and the corner radius.
In the Styles tab: the height of the block for each device, the strength of the background, the spacing, the accent color and a panel for each element.
A product that is out of stock keeps its main button, with what WooCommerce says about it.
Blocks of products
Product Grid
Products in a grid.
Sources of products
- Newest products
- Hand-picked products
- Categories
- Tags
- Featured products
- Products on sale
Layouts: Showcase, Classic, Minimal, Editorial, Compact, Soft Cards, Overlay, Horizontal and Featured First. A layout sets the shape and the look of the grid; the products, the texts and the colors you chose stay as they are.
For the visitor, each one optional:
- Category tabs, to see the products of one category.
- Sorting, by date, name or price.
- Load more, to bring more products without leaving the page.
- Quick buy, to add a product to the cart without a reload.
Without JavaScript the tabs and the sorting are links and a form, and work the same.
The card can show the photo, the name, the rating, the price, the saving of a product on sale, the short description, the sale badge, the stock badge and the button. Each has its own panel in the Styles tab. You also choose the proportion of the photo (1:1, 4:5, 3:4, 4:3 or 16:9), the style of the card (elevated, plain, outlined or soft) and the number of columns for each device.
The first product can be featured, larger than the others, with its own description and button.
The short description of a product protected by a password is never shown.
Blocks of products
Product Carousel
Products in a row that scrolls.
Sources of products: the six of the Product Grid, and also:
- Best sellers
- Top rated products
- Related products
- Upsells
- Recently viewed
Related products and Upsells follow the product of the page, or one you choose. When a source has nothing to show, the block can be hidden or show another source in its place.
Layouts: Showcase, Classic, Compact, Minimal, Soft Cards, Overlay, Horizontal, Editorial, Spotlight, Centered, Two Rows and Featured First.
The row
- arrows, shown or hidden for each device, always or only under the pointer;
- dragging with the mouse or a finger;
- how the row moves: one product at a time or a page at a time;
- what happens at the end: stop, go back to the start, show a card that leads to all the products, or loop;
- automatic rotation, which a visitor can pause;
- a part of the next card in view, to show there is more;
- the edges faded, and the cards with the same height.
Other options: a heading with a label, a title and a subtitle; a link to see all the products; a second photo of the product under the pointer; products out of stock as the store shows them, last, or hidden; and quick buy.
Without JavaScript the row scrolls with the finger, the mouse or the keyboard.
Recently viewed
This source shows each visitor the products they opened. The history is kept in the browser of the visitor, not on your site: up to 24 products, each for 30 days. See Privacy for the details.
Blocks of content
About the Product
The story of the product: a label, a title, a text, up to four highlights, a fact in evidence and up to two buttons, beside a photo or over it. The text can be copied from the description of a product. The photo can be turned off.
Blocks of content
Product Features
Cards with a photo, a number or an icon, a title and a text. The cards are arranged with one featured card beside the others, or as an even grid. Each card has its own photo, with a color over it and its intensity, and its photo can be turned off.
Blocks of content
Product Hotspots
Numbered points over a photo of the product. Each point opens a panel with a title, a subtitle, a text and a photo of its own.
- Drag a point over the photo to place it, or set its position in the sidebar, with the keyboard.
- The photo can sit at the start or at the end, and you can set its width and its corner radius.
- The points can pulse, and show their numbers.
Without JavaScript every point is shown as a list, with its panel.
Blocks of content
Comparison Table
Your product beside the alternatives, feature by feature. One column is featured, with a badge. Each cell has a text and a mark (yes, no or none). A button goes under the table.
On a narrow screen each feature becomes a line of its own, with its name over what each column says.
Blocks of content
Testimonials
What buyers say, in a row of cards that slides: a photo, a name, stars and a quote, under a heading with the average rating and a strip of short facts.
The testimonials can be written by hand or taken from the approved reviews of a product.
A testimonial written by hand shows the “Verified purchase” seal only when you turn it on. Use it for purchases you can verify. The average rating and the number of reviews of a block written by hand are the text you write: they are not read from the store.
Blocks of content
FAQ
Questions that open to show their answers, in one or two columns, with a heading, an optional photo and a strip of short facts.
- Each question can start open or closed, and the block can keep only one open at a time.
- The block adds the FAQ structured data for search engines. It can be turned off.
A question is opened by the browser itself, with no script.
Blocks of content
Carousel Gallery
One large photo that slides, the next two beside it and a row of thumbnails, under a heading. The photos are the ones you choose or the gallery of a product.
With one or two photos, the large photo keeps the width it has in a gallery with more photos, centered.
Blocks of content
Grid Gallery
Photos in a grid, each with a caption, or as a mosaic of photos of different sizes, under a heading. You choose two, three or four columns and the proportion of the photos.
Blocks of content
Page Header
The bar at the top of a landing page: the brand (a text, an icon or an image), the links to the sections of the page and a button. It can stay at the top while the page scrolls. On a phone the links are in a menu.
It is made for a page whose template has no header.
Blocks of content
Linking the bar to the sections
The Page Header links to sections of the same page. For a link to work:
- Select the block the link should lead to.
- In the sidebar, open Advanced and write a name in HTML anchor, such as
gallery. - In the Page Header, use the address
#galleryfor that link.
The landing pages of the plugin come with their anchors and links already set.
Reference
Privacy
- No request to another server. The plugin loads nothing from outside your site.
- No data of visitors on your site. The plugin keeps no option, table or cookie with data of your visitors.
- Recently viewed. With this source in use, the browser of each visitor keeps the products that visitor opened: product IDs and dates, up to 24 products, each for 30 days, in the storage of the browser. The list is sent to your site only to draw the cards, and nothing on the server keeps it.
- Consent. With a consent plugin that supports the WP Consent API, the history is recorded and read only when the visitor allows the “preferences” category. When the consent is taken back, the history is removed from the browser. Without such a plugin on the site, the history is recorded.
- Sign-up form of the Page Footer. It sends the address the visitor writes to the service you set. Say so in your privacy policy.
Reference
Languages
The plugin is written in English and comes with a Brazilian Portuguese translation. It is ready to be translated to other languages.
Reference
Performance
- A page loads the styles and the scripts only of the blocks it uses. A page with no block of the plugin loads nothing from it.
- The lists ordered by sales or by rating, which are the heaviest to work out, are kept for up to one hour and renewed when a product is saved or changes stock. Sales made since then show within the hour.
- The Product Hero at the top of a page loads its image first, to be the first thing a visitor sees.
Reference
Deleting the plugin
When the plugin is deleted from the Plugins screen, the cached data it keeps (transients whose name starts with wpdefcs_) are removed. The blocks stay in the content of your pages, and are shown again if you install the plugin again.
The history of “Recently viewed” in the browser of each visitor expires by itself in at most 30 days.
Reference
Troubleshooting
The blocks do not appear in the inserter.
Check that WooCommerce is active and that the versions of WordPress, WooCommerce and PHP meet the requirements.
A block of the full width does not reach the edges of the screen.
The template of the page limits the width of the content. Choose a full-width template of your theme.
The landing page shows two headers, or two footers.
The template of the page has the header and the footer of the theme. Choose a template without them, or remove the Page Header and the Page Footer of the landing page.
A list of products is empty.
The source has no product to show: no product in that category, none featured, none on sale. Choose another source, or set what the block shows in its place.
A photo of the Product Hotspots is too small.
The photo is shown at the size it comes in. Set its width in the Styles tab, in the panel Photo.
A product I changed still shows the old price in a list.
The blocks read the price from the store each time the page is drawn. If your site has a page cache, clear it.
The dashboard screen is in English.
The plugin follows the language of your user. Set it in Users > Profile > Language.
Reference
For developers
The blocks are named wpdefcs/… and their CSS classes start with wpdefcs-. The source of the scripts and of the styles comes with the plugin, in the src folder; to build it, run npm install and npm run build in the folder of the plugin.
| Filter | What it does |
|---|---|
wpdefcs_max_products | The most products one block may show. |
wpdefcs_load_more_max_products | The most products “Load more” may bring. |
wpdefcs_random_seed | Fixes the seed of the random order (a positive integer). |
wpdefcs_recently_viewed_tracking | Turns the recording of visits on or off. |
wpdefcs_recently_viewed_consent_category | The WP Consent API category the history needs. |
Reference
Credits and license
Definitivo Commerce Studio is free software, under the GPL version 2 or later.
The icons are a subset of Lucide, under the ISC license (with the MIT license of the Feather icons it keeps).