[project_element]
This is the main shortcode for displaying the project listing section on a page.
Product
Shortcode Attributes
There are a number of shortcode attributes available which you can use to customize the output.
GENERAL LAYOUT
- listing_only – If set to
on, only the project listing will be displayed without additional layout.- Default:
off. - Options:
on,off. Specify one only.
- Default:
- layout – Determines the layout of the projects.
- Default:
grid. - Options:
grid,carousel.
- Default:
- display – Controls how the project content is displayed relative to the image.
- Default:
image-above-content. - Options:
- ORDINARY DISPLAYS:
image-above-content,image-overlay-content,content-only. Specify one only. - SPLIT DISPLAYS:
image-left-content,image-right-content. Specify 2 (Split and Split Size). Use commas to separate. - SPLIT DISPLAY SIZES (Required on Split Display):
split-25-75,split-40-60,split-50-50,split-60-40. Specify 3 (Split, Split Size, and Alternate Split). Use commas to separate. - ALTERNATE SPLIT DISPLAY (Can use only on Split-50-50 and on the opposite option of the Split Display):
then-left,then-right.
- ORDINARY DISPLAYS:
- Default:
- per_row – Number of projects to display per row in grid layout.
- Default:
3. - Options:
1–6. Specify one only.
- Default:
GRID LAYOUT
- grid_layout – The grid layout style.
- Default:
default-grid-layout. - Options:
default-grid-layout,grid-layout-1,grid-layout-2,grid-layout-3,masonry-layout-1. Specify one only.
- Default:
- per_page – Number of projects to display per page.
- Options: Any numeric value. Specify one only.
- pagination – Pagination type.
- Default:
loadmore. - Options:
loadmore,pagination. Specify one only.
- Default:
- search_filter – Enable or disable search filter.
- Options:
on,off. Specify one only.
- Options:
CAROUSEL LAYOUT
- carousel_layout – The carousel layout style.
- Default:
default-carousel-layout.
- Default:
- autoplay – Enable or disable autoplay for the carousel.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- slider_speed – Autoplay speed in seconds.
- Default:
6. - Options: Any numeric value.
- Default:
- slider_arrows – Show or hide navigation arrows.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
- slider_dots – Show or hide navigation dots.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
DESIGN
- element_width – Width of the element.
- Default:
default-width. - Options:
default-width,small-container,medium-container,large-container,row-fluid. Specify one only.
- Default:
- alignment – Alignment of the content.
- Default:
default-alignment. - Options:
default-alignment,text-left,text-center,text-right,text-justified. Specify one only.
- Default:
- theme – Theme or style for the section.
- Default:
default-section. - Options:
default-section,light-section,grey-section,dark-section,theme-section,second-theme-section. Specify one only.
- Default:
- background – Background color or image for the element.
- Options: Any image URL.
- classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS. Use spaces to separate
- id – Custom ID for the element.
HEADER
- heading – Main heading text on the post element section.
- Options: Any text value.
- heading_size – Heading size.
- Default:
h2. - Options:
h1,h2. Specify one only.
- Default:
- sub_heading – Subheading text.
- Options: Any text value.
CONTENT
- meta – Metadata to display for each project.
- Default:
description. - Options:
description,status,category,tag. Use commas,to separate values.
- Default:
- content – Content to display for each project.
- Default:
description. - Options:
description,excerpt. Specify one only.
- Default:
- max_words – Maximum number of words to display in the content.
- Default:
20. - Options: Any numeric value.
- Default:
- link_type – Type of link to display for each project.
- Default:
button. - Options:
button,text,none. Specify one only.
- Default:
- show_in_modal – Displays project details in a modal.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- show_gallery – Displays a gallery of project images.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- lightbox – Enables lightbox for project images.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- limit – Limits the number of projects displayed.
- Options: Any numeric value.
- orderby – Order projects by a specific field.
- Default:
date. - Options:
id,date,title,menu_order,rand. Specify one only.
- Default:
- order – Order direction..
- Default:
desc. - Options:
asc,desc. Specify one only.
- Default:
FILTER
- featured – Displays only featured projects.
- Default:
no. - Options:
no,yes. Specify one only.
- Default:
- categories – Filter projects by categories. Comma-separated list of category IDs or slugs.
- tags – Filter projects by tags. Comma-separated list of tag IDs or slugs.
- projects – Filters projects by specific project IDs. Comma-separated list of post IDs.
Example Usage
[project_element layout="grid" per_row="4" heading="Our Projects" sub_heading="Check out our latest work" categories="1,2,3" tags="web-design,development"]
| Example: This example displays the projects in a grid layout with 4 posts per row. It shows a main heading ( Our Projects) and a sub-heading (Check out our latest work) above the project listing. Filter the projects to include only those that: belong to the categories with IDs 1, 2, 3 and have the tags web-design and development. |
pagination attribute allows you to control how additional projects are loaded (e.g., loadmore).