# Gridcard Package contents

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

Requirements Gridcard 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 Grid particle (i.e: Home) -> Layout tab -> Drag and drop the Grid Particle from Particles panel (left corner) to the section you want to display the particle.

Settings

Tab Content

Settings	Description
Items	List Grid items to show. You can add new items to the collection using the plus + icon

Items You can add new items to the collection using the plus + icon

Settings	Description
Title	Enter the item title
Meta	Enter the item meta
Content	Enter short content
Image	An image field with an image picker.
Image ALT	Enter the image’s alt attribute.
Link	Specify the button link.
Link Text	Specify the button label.
Tags	If you want to use filter tag option, enter a comma-separated list of tags, for example: blue, white, black.
CSS Classes	Specify the CSS class name for item.

Card Common settings for card style

Settings	Description
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.
Max Width	Set the maximum width.
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	Add CSS class name for the particle.

Tab Grid

Grid Settings Common settings for grid layout

Settings	Description
Enable Masonry	The masonry effect creates a layout free of gaps even if grid cells have different heights.
Parallax	The parallax effect moves single grid columns at different speeds while scrolling. Define the vertical parallax offset in pixels.
Column Gap	Set the size of the gap between the grid columns.
Row Gap	Set the size of the gap between the grid rows.
Match Height	To match the height of the direct child of each cell.
Dividers	Display dividers between grid cells.
Center columns	Use this option to center the grid cell columns.
Center rows	Use this option to center the grid row columns.

Example without Match Height

With Match Height enabled.

Columns/Filter Common settings for Columns and Filter

Settings	Description
Columns Settings	Common settings for Grid columns layout.
Phone Portrait	Set the number of grid columns for each breakpoint. Inherit refers to the number of columns on the next smaller screen size.
Phone Landscape
Tablet Landscape
Desktop
Large Screens
Filter Settings	Common settings for Filter
Enable Filter	Enable filter navigation for Gridcard.
Reverse order	Enable tags reverse order.
All Items	Show filter control for all items.
All Items Label	Replace the All label tag.
Style	Select the filter navigation style. The pill and divider styles are only available for horizontal Subnavs.
Position	Position the filter navigation at the top, left or right. A larger style can be applied to left and right navigations.
Primary navigation	This option won’t have any effect IF the Filter Style is set to Tab and Filter position is set to Top.
Alignment	Align the filter controls. The Alignment styles are only available for TOP filter position.
Margin	Set vertical margin. The Margin styles are only available for TOP filter position.
Grid Width	Define the width of the filter navigation. Choose between percent and fixed widths or expand columns to the width of their content. This feature is available for Left/Right filter Position only.
Grid Column Gap	Set the size of the gap between between the filter navigation and the content.
Grid Row Gap	Set the size of the gap if the grid items stack.
Grid Breakpoint	Set the breakpoint from which the filter navigation and grid will stack.
Show tooltip	Show tooltip title when hovering on the tag items
Tooltip Position	Choose one of these options to adjust the tooltip’s alignment.

Tab Image

Image Settings Common settings for Image Style

Settings	Description
Load image eagerly	By default, images are loaded lazy. Enable eager loading for images in the initial viewport.
Width	Set the width of the image.
Height	Set the height of the image.
Image Border	Select the image’s border style. This option won’t have any effect unless the Card Style is set to Panel.
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.
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. Note that the margin will only apply if the content field immediately follows another content field. This option won’t have any effect unless Image Alignment is set to Bottom or Between.

Tab Style

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. Note that the margin will only apply if the content field immediately follows another content field.

Content Settings Common settings for Content Style

Settings	Description
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.
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?

Link Settings Common settings for Link Style

Settings	Description
Target	Target browser window when item is clicked.
Link Text	Specify the button label.
Icon	Pick an optional Font Awesome icon.
Icon Alignment	Choose the icon position.
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.
Transform	The following options will transform text into uppercased, capitalized or lowercased characters.
Margin Top	Set the top margin. Note that the margin will only apply if the content field immediately follows another content field.

General, Parallax and Parallax Background tab

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

Video Tutorial