Card Particle Documentation

  • Tony
  • 3 October 2018
  • No comments
  • Docs
Display text with an image optionally styled like a card. See how Card can be designed beautifully on Demo Page.

# Card Package contents

Files Description
jlcard.yaml Contains the Card particle field settings.
jlcard.html.twig The Twig file to pull information, settings.

Installation Installing the particle on your website is a really simple process. You can refer to the document here to know more.

Requirements Card requires Uikit 3 for Gantry 5 Atom to be installed and enabled in your theme layout settings.

Go to Template/Theme Settings > select the Layout to add Card particle (i.e: Home) -> Layout tab -> Drag and drop the Card Particle from Particles panel (left corner) to the section you want to display the particle.

Settings

Tab Content

Settings Description
Title. Customize the title.
Meta Customize the meta.
Content Customize the content.
Image An image field with an image picker.
Image ALT Enter the image’s alt attribute.
Link Specify the link for heading.
Note: Scroll smoothly added automatically to internal link that contains a URL fragment to add the smooth scrolling behavior.
Target Open the link in a same or new window.
Link text Specify the button label.
Card Settings Common style settings for Card
Style Select one of the boxed Card, Tile styles or a blank Panel.
Padding Set the padding for the boxed Card or Tile styles.
Link card Link the whole card if a link exists.
Panel Padding Set the Panel size padding.
Align image without padding Top, left or right aligned images can be attached to the card’s edge. If the image is aligned to the left or right, it will also extend to cover the whole space.
This option won’t have any effect IF the Style is set to Panel or Image Alignment is set to Between.
CSS Classes CSS class name for the particle.

Image Tab

Image Settings Common settings for Image Style, including Conditional Fields.

Settings Description
Load image eagerly By default, images are loaded lazy. Enable eager loading for images in the initial viewport.
Width Enter the image’s width.
Height Enter the image’s height.
Image Border Select the image’s border style.
This option won’t have any effect if Align image without padding is enabled.
Box Shadow Select the image’s box shadow size.
This option won’t have any effect unless the Card Style is set to Panel.
Hover Box Shadow Select the image’s box shadow size on hover.
This option won’t have any effect unless the Card Style is set to Panel.
Link image Link the image if a link exists.
Hover Transition Set the hover transition for a linked image.
Alignment Align the image to the top,left, right or place it between the title and the content.
Grid Width Define the width of the image within the grid. Choose between percent and fixed widths or expand columns to the width of their content.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Column Gap Set the size of the gap between the image and the content.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Row Gap Set the size of the gap if the grid items stack.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Grid Breakpoint Set the breakpoint from which grid cells will stack.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Vertical Alignment Vertically center grid cells.
This option won’t have any effect unless Image Alignment is set to Left or Right.
Margin Top Set the top margin.
This option won’t have any effect unless Image Alignment is set to Bottom or Between.

Style Tab

Title Settings Common settings for Title Style

Settings Description
Style Heading styles differ in font-size but may also come with a predefined color, size and font.
Link title Link the title if a link exists.
Hover Style Set the hover style for a linked title. Enable link title to use this option.
Decoration Decorate the headline with a divider, bullet or a line that is vertically centered to the heading.
Predefined Color Select the text color. If the Background option is selected, styles that don’t apply a background image use the primary color instead.
Custom Color Customize the title color instead using predefined title color mode.
You need to set the predefined color to None to use the customize color option.
Font Size Customize the title text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
Font weight Add one of the following classes to modify the font weight of your text.
HTML Element Choose one of the elements to fit your semantic structure.
Alignment Align the title to the top or left in regards to the content.
Grid Width Define the width of the title within the grid. Choose between percent and fixed widths or expand columns to the width of their content.
Grid Column Gap Set the size of the gap between the image and the content.
Grid Row Gap Set the size of the gap if the grid items stack.
Grid Breakpoint Set the breakpoint from which grid cells will stack.
Margin Top Set the top margin.

Meta Settings Common settings for Meta Style

Settings Description
Style Select a predefined meta text style, including color, size and font-family.
Predefined Color Select the predefined meta color.
Custom Color Customize the meta color. Set Predefined Color for Meta to None before using this feature.
Font Size Customize the title text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
Font weight Add one of the following classes to modify the font weight of your text.
HTML Element Choose one of the elements to fit your semantic structure.
Alignment Align the meta text above/below the title or below the content.
Margin Top Set the top margin.

Content Settings Common settings for Content Style

Settings Description
Process Twig Enable Twig template processing in the content. Twig will be processed before shortcodes.
Process shortcodes Enable shortcode processing / filtering in the content. This useful when you want to load the Joomla module or WordPress shortcode inside the card content, example you can add a Joomla shortcode inside the card content like {loadmoduleid your_moduleId}, then just enable the Process shortcodes feature and done. This solution similar to How do you put a module inside an article?
Style Select a predefined text style, including color, size and font-family.
Force left alignment Force left alignment for the content if the text center/text right is set via general tab.
Enable drop cap Display the first letter of the paragraph as a large initial.
Columns Set the number of list columns.
Show dividers Show a divider between list columns.
Columns Breakpoint Set the device width from which the list columns should apply.
Predefined Color Select the predefined meta color.
Customize Color Customize the content color instead using predefined text color.
You need to set the predefined color to None to use the customize color option.
Font Size Customize the content text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.
Font weight Add one of the following classes to modify the font weight of your text.
Margin Top Set the top margin.

Link Settings Common settings for Link Style

Settings Description
Link Text Specify the button label.
Icon Pick an optional Font Awesome icon.
Icon Alignment Choose the icon position.
Target Open the link in a same or new window.
Style Set the button style.
Button Size Set the button size.
Full width button Set the fullwidth for button.
Font weight Add one of the following classes to modify the font weight of your text.
Margin Top Set the top margin.

General, Parallax and Parallax Background tab

Please take a look the documentation here for more detail about these tabs settings

Video Overview

Comments

Leave a Reply

You must be logged in to post a comment.

JoomLead Gantry5 Particles 2.2.10 released, new features, bug fixes and more Learn more
Flash Sale. Get Up to 25% Off - Coupon: FLASH25 Shop Now