Block Icons With Text: Difference between revisions

From Posstack.com Documentation
 
Line 210: Line 210:
The following guidelines explain how to create an Icons with Text grid, which can also be applied to set up an Instagram/TikTok or YouTube slider.
The following guidelines explain how to create an Icons with Text grid, which can also be applied to set up an Instagram/TikTok or YouTube slider.


'''Video Tutorial''': Watch this [https://www.youtube.com/watch?v=9B08nQeX11g video tutorial] to discover how to add video sliders from YouTube, TikTok, Instagram, or Vimeo to your Shopify product page using Icons With Text metaobjects.
'''Video Tutorial''':  
 
Watch this [https://www.youtube.com/watch?v=9B08nQeX11g video tutorial] to discover how to add video sliders from YouTube, TikTok, Instagram, or Vimeo to your Shopify product page using Icons With Text metaobjects.
[[File:Ecb youtube video slider iwt.jpg|800px|frameless]]
[[File:Ecb youtube video slider iwt.jpg|800px|frameless]]



Latest revision as of 14:45, 12 December 2024


Easy Content Builder offers 4 sections for managing images:
  • Image Section: Ideal for showcasing a single image.
  • Images With Text: Great for presenting images alongside headings, descriptions, and CTA buttons, with the option to customize the ratio of image to text.
  • Gallery: Perfect for creating a grid of photos and videos. Clicking on an image or video opens a lightbox popup to display related content.
  • Icons With Text: Designed for displaying a slider or grid of images, icons, and text. This section can be used for showcasing Trust Badges, a scrolling announcement bar, logo lists, testimonials, or any text columns with icons.

Overview

Icons With Text helps you create separate content blocks (Each block comes with its heading, description, and icon). You can easily position the icon (left, right, center, or bottom) to pair with the wrapped text.  

What is the Icons With Text section perfect for?

You have various options to use the Icons With Text section for your Shopify themes:

  • Trust badges: See an example here.
Ecb-icon-text-demo8.png
  • Payment icons: See an example here.
Ecb-icon-text-demo1.png
  • Shipping info: See an example here.
Ecb-icon-text-demo7.png
  • Feature highlights: See an example here.
Ecb-icon-text-demo2.png
  • Testimonial slider: See an example here.
Ecb-icon-text-demo4.png
  • Logo Listing: See an example here or scrolling logo list:
Ecb-icon-text-demo6.png

Watch video tutorial

Be sure to watch the step-by-step video tutorials demonstrating how to utilize the sections provided in Posstack Easy Content Builder, available here.

How to add Icons With Text section

  • Step 1: Add a Section Settings section that allows you to control the global settings of the Icons With Text section.
In this special section, you can specify multi-column layouts, activate full width, determine the section's maximum width, choose a background color, and set global margins and padding, among other options.
Note: If you include the Icons With Text in the core product information, skip the step for adding Section Settings. Just add the Icons With Text. Ecb add section core product info.jpg
  • Step 2: Add an Icons With Text section and customize the settings according to your preferences.
Block section title.png
If you are new to our Easy Content Builder, please take a look at the Add Sections section for detailed instructions on how to add a section to your theme.

Icons With Text settings

From the Shopify theme editor, click on Icons With Text (previously Features block) on the sidebar to view the details of settings.

Block features.png

If you are new to our Easy Content Builder, please take a look at the Add Sections section for detailed instructions on how to add a section to your theme.
Section settings Description
Image Position Set the position of the icon (left, right, center, bottom) to pair with the wrapped text. Applied to desktop view only.
Text Alignment Align all content elements to the left, right, or center.

If "Inherit" is enabled, the text alignment will follow the page's configuration. This is helpful for RTL (right-to-left) pages, as it automatically adjusts the direction of text and icons in Icons With Text from left-to-right (LTR) to right-to-left when languages such as Arabic, Persian, or Hebrew are changed.

Set the icon/image width Enter image-width-100 (replace 100 with the desired value) to the CSS classes field.

NOTE: Once you define the width of the icon/image, make sure you configure the number of items per row on Mobile/Desktop, like the examples below:

Icons-w-text-1col.jpgIcons-w-text-width.jpg

CSS classes // Enter Custom CSS classes:
  • Add a style to cards: uk-card-primary uk-height-1-1 uk-padding
  • Set the icon width: image-width-100 (replace 100 with the desired value).
  • Convert items into sliders: slider. Show the slider with navigation arrows: slider-nav.
  • Set the Heading font-weight: learn more here.
  • Apply a different color to the text element: learn more here.
  • Use metaobjects as a dynamic source: dynamic-source (Learn step-by-step guide here)

// Collapsible Text Columns with Icons

  • toggle: use this class to create Collapsible Text Columns with Icons that function similarly to an Accordion section.

// Enable Auto-scrolling:

To enable auto-scrolling (Perfect for Logo slider, scrolling announcement text, Testimonial slider, etc.), add the CSS classes below:

  • scrolling: scrolling from right to left.
  • scrolling-r: scrolling from left to right.
  • duration-10: Specify the animation's duration (in seconds), which should complete one cycle. Replace '10' with your desired value.
  • nowrap: to show text in one row (helpful for the Scrolling Announcement bar)
  • overflow-hidden: the scrolling items will be shown within the block's container.
  • max-width-200: Set item max width (replace 200 with your desired width).
NOTE: If you do not set max-width-value, each image's maximum width is 280px. To set the image bigger than 280px, you must specify both image-width-value and max-width-value (input the value as you wish. Make sure the value of image-width-value is always smaller than that of max-width-value.

// Enable Instagram Feed, Tiktok/Youtube Slider:

  • dynamic-source modal image-width-400 slider slider-nav: show a regular Instagram/Tiktok/Youtube video slider (like this example).
  • dynamic-source modal image-width-400 scrolling duration-100: show an auto-scrolling instagram feed or Tiktok/Youtube video slider.

INFO: Currently, the metaobjects used as a dynamic source can be used on 3 page types: product page, store page, and blog post page.

NOTE: The Slider, Auto-scrolling, and Metaobject features are only available for the PRO plan. To add multiple classes, enter the classes with space between them.

Items per row on Mobile Set the number of featured content blocks displayed per row on Mobile devices.
Items per row on Desktop Set the number of featured content blocks displayed per row on Desktop devices.
Animate On Scroll This feature is only available for the Pro plan. It lets you apply different types of animation to elements within each section as you scroll down the page. Learn more about scrolling animations here.
Item Title Enter the title of each featured content block.
Icon Upload the SVG Icon, Icon Font, or Image
Body Add and style (bold, italic, add link) the text content that appears on each block.

Collapsible Text Columns with Icons.

Iwt collapsible.jpg

NOTE: This feature is only available for the PRO plan.

How to create a collapsible Text Columns with Icons:

  • Step 1: Create a Section Settings to control the global settings of the slider (where you specify this section’s column layout, width, background color, etc.)
  • Step 2: Create an Icons With Text section.
  • Step 3: Enter 'toggle' class to enable collapsible Text Columns with Icons. Then add 'image-width-24' class (change the width value '24' as you wish) to set the width of your icons.
  • Step 4: Set your desired Items per row on Desktop/Mobile.
  • Step 5: Open the Icons With Text configuration and insert the title/body text/icon (SVG, Icon font, or Image) depending on which content type you want to display.

Scrolling announcement bar and infinite logo/image carousel.

Ecb scrolling vid.gif

NOTE: This feature is only available for the PRO plan.

How to create a scrolling logo list/text bar/image carousel:

  • Step 1: Create a Section Settings to control the global settings of the slider (where you specify this section’s column layout, width, background color, etc.)
  • Step 2: Create an Icons With Text section.
  • Step 3: Open the Icons With Text configuration and insert the title/body text/icon (SVG, Icon font, or Image) depending on which content type you want to display.
  • Step 4: enter these additional classes into the CSS Classes field depending on the scrolling style you want:
Note: You can add multiple classes, type the classes with space between them.
  • scrolling: scrolling from right to left.
  • scrolling-r: scrolling from left to right.
  • duration-10: Specify duration (in second) that the animation should complete one cycle. Replace '10' with your desired value.
  • nowrap: showing text messages in one row (helpful for Scrolling important messages)
  • overflow-hidden: scrolling items will be shown within the block's container.
  • max-width-200: Set the items’ maximum width (replace 200 with your desired width).
NOTE: If you do not set max-width-value, each image's maximum width is 280px by default. To show images bigger than 280px, you must specify both the image-width-value and max-width-value (input the value as you wish. Make sure image-width-valuemax-width-value.)

Below are a few examples of logo/text/image carousels we created for demo purposes:

Scrolling announcement bar (full-width):
Ecb-guide-scrolling-text.jpgScrolling announcement bar (shown within a column container):
Ecb-guide-scrolling-text-overflow-hidden.jpg
Scrolling logo list:
Ecb-guide-scrolling-logos.jpg
Infinite image carousel:
Ecb-guide-scrolling-images.jpg


Testimonial Carousel

NOTE: This feature is only available for PRO plan.

You can use Icons With Text block to create a Testimonial carousel by entering these additional classes into the Item Style field:

  • slider: to enable the carousel
  • slider-nav: to enable the arrow navigation
Note: You can add multiple classes, just type the classes with space between them.
See the Testimonial carousel demo here.

How to create a Testimonial:

  • Step 1: Create a Section Settings to control the global settings of the carousel (The whole block width, background color, etc.)
  • Step 2: Create an Icons With Text section.
  • Step 3: Open the Icons With Text configuration and insert the title, Icon (SVG, Icon font, or Image), and body text as you wish.

Note: You can define the number of Testimonial items per row from 1 up to 6 items (using the Mobile & Desktop configuration).

Below is an example of a Testimonial carousel that displays 3 items:

Add testimonial slider.jpg

How to add SVG icons to Icons With Text

Upload SVG icons
AUG 2023 - IMPORTANT NOTE: Shopify now allows uploading SVG files. For those who used SVG inline (under the Icons With Text block), which is now deprecated, you are required to re-upload those SVG icons to be compatible with the new change in Shopify. Then update your icons' width by following this guide.
Set the icon width

To adjust the icon's width, simply enter the extra class into the CSS classes field: image-width-100 (replace 100 with the desired value).

Change the SVG icon color

Here are steps to adjust the SVG icon's color:

  • Step 1: Convert your HEX color to CSS filter property.
Simply use this free tool, enter your HEX color format (e.g. #121212) to convert to CSS filter property. Then, copy the generated CSS filter result.
CSS-color-filter-convert.png
  • Step 2: Navigate back to your Theme Editor > click on the App section containing the Icons With Text block where you want to change the SVG icons' color.
  • Step 3: Paste the generated CSS filter property into the Custom CSS field. And hit Save.
CSS-color-filter-generator.jpg

How to create an Icons With Text metaobject

Note: Connecting metaobjects to your Online Store through dynamic sources is available for the Pro version only. Go Pro.
When to use the Icons with Text metaobject:

Step-by-step guide:

The following guidelines explain how to create an Icons with Text grid, which can also be applied to set up an Instagram/TikTok or YouTube slider.

Video Tutorial:

Watch this video tutorial to discover how to add video sliders from YouTube, TikTok, Instagram, or Vimeo to your Shopify product page using Icons With Text metaobjects. Ecb youtube video slider iwt.jpg

Step 1: Update Staff permissions

If your store has multiple staff members, make sure you assign the right permission for staff to work on the metaobjects.

Staff-permission.jpg
Otherwise, your staff can not add entries when working with the metaobjects.
Permission notice.png
Step 2: Create Metaobjects
  • From your Shopify admin, navigate to Apps > Posstack Easy Content Builder > Custom Data.
  • Click on Create next to the desired content type (Icons With Text, Tabs, Accordions). Once created, you should see the message Metaobject and Metafield created:
Metaobject created.png
To create an Instagram Feed/ Tiktok & Youtube Slider like this example, you simply create Icons With Text metaobject in this step.
  •  And all metafields associated with the above-mentioned metaobjects are automatically created too. You can check those metafields by following these steps:
    • In your Shopify admin, click Settings > Custom data
    • You should see 3 metafields Products, Pages, Blog Posts:
Metafields created.jpg
    • Click on each metafield Products, Pages, or Blog Posts to see the metafield definitions:
Metafield definitions.png
Step 3: Create entries for the Metaobjects
  • From your Shopify admin, select the part of your store that you want to add a metaobject to. For example, Products (Easy Content Builder now supports metaobjects for Products, Pages, Blog Posts).
  • Click the name of a product you want to edit.
  • In the Metafields section, click on the form field to add an entry (ECB Accordions, ECB Tabs, or ECB Icons With Text depending on which metaobjects you created in Step 2)
Add-entries.jpg
  • Next, click Select Entry > Create New Entry and complete the fields for your entry. Once done, click Save.
Add-entries-detail.png
To create other entries, you repeat the exact steps by clicking Select Entry > Create New Entry. If you have already created entries, simply click the checkboxes to determine which entries will be displayed on your storefront. Here is an example of metaobject entries we created for demo purposes:
Icon entry examples.jpg
Here's a sample Metaobject entry that stores the Instagram video information, which will be displayed on the storefront in a format similar to the Instagram Feed/Tiktok & Youtube Slider example.Ecb instagram entry.png
  • Once done, click Save.
Step 4: Connecting metaobjects to your Online Store through dynamic sources
  • From your Shopify admin, click Apps > Easy Content Builder
  • From the Easy Content Builder dashboard, click Manage Templates.
  • Then select the template that you want to edit and click Customize.
  • From the Theme Editor, open the Icons With Text block where you want to edit. Then insert two classes into the CSS classes field: dynamic-source image-width-100 (replace 100 with the desired value for your icons' width).
When you add the class dynamic-source to Icons With Text, it will automatically link to your metaobjects (list entries type). This means you won't have to manually map each individual entry in Icons With Text. Importantly, this approach allows you to add more than 6 items, compared to manually mapping each field.
Dynamic source.jpg
To display the Instagram Feed or Tiktok video slider as shown in this example, you should input the following classes into the CSS classes field: dynamic-source modal image-width-400 slider slider-nav
Or input the following classes into the CSS classes field to show an auto-scrolling instagram feed: dynamic-source modal image-width-400 scrolling duration-100

Set the Heading font-weight

You may want to use additional classes to set the weight of the title to bold when needed. Add one of the classes below to the field 'Item Style':

  • uk-title-bold: set the Heading's weight to bold (See the Icons with text demo with bold title)
  • uk-text-bold: set the weight of both the Heading and body text to bold

Ecb guide icons text.jpg

Apply a different color to text element

You can also use one of these classes to apply a different color to text elements.

  • uk-text-muted: Add this class to mute text.
  • uk-text-emphasis: Add this class to emphasize text.
  • uk-text-primary: Add this class to emphasize text with the primary color.
  • uk-text-secondary: Add this class to emphasize text with the secondary color.
  • uk-text-success: Add this class to indicate success.
  • uk-text-warning: Add this class to indicate a warning.
  • uk-text-danger: Add this class to indicate danger.
Note: You can add multiple classes, just type the classes with space between them.

Ecb guide icons text classes.jpg

Create layout boxes with different card styles

You can add a specific card style to the Icons with text block by using these additional classes:

uk-card-primary uk-height-1-1 uk-padding

See the card style demo: here

By default, you can apply three styles to cards:

  • uk-card-default: create a visually styled box.
  • uk-card-primary: emphasize the card with a primary color.
  • uk-card-secondary: give the card a secondary background color.

Ecb guide icons text cardstyle.jpg

Add other content blocks

You can add many content blocks to a section you've created. These content blocks will be displayed in different positions within the section, depending on the Desktop/Mobile Layouts you configure.

Ecb-block-v2.jpg

See all content blocks available that you can add to a section.