Floor plan grid
The floor plan grid shortcode is most appropriate when you want to show multiple sets of floorplans on the same page (the search can only load once per page), or if you
The [rentfetch_floorplans] shortcode displays a static grid of floor plans without search filters. This layout ignores availability and is useful for displaying arbitrary groupings of floor plans in a simple grid format.
Basic Usage
[rentfetch_floorplans]
This displays all published floor plans in a grid layout.
Parameters
- property_id: Limits the display to floor plans from specific properties. Accepts a single property ID or multiple IDs separated by commas.
- Example:
[rentfetch_floorplans property_id=p1234] - Example:
[rentfetch_floorplans property_id="p1234,p5678"]
- Example:
- beds: Filters the floor plans to show only those with specific bedroom counts. Accepts single values or multiple values separated by commas.
- Example:
[rentfetch_floorplans beds=2] - Example:
[rentfetch_floorplans beds="1,2,3"]
- Example:
- sort: Determines the ordering of the floor plans in the grid. Available options:
availability,beds,baths,pricelow,pricehigh,alphabetical,menu_order.availability: Sorts by number of available units (highest first)beds: Sorts by number of bedrooms (ascending)baths: Sorts by number of bathrooms (ascending)pricelow: Sorts by minimum rent (lowest first, excludes rents under $100)pricehigh: Sorts by minimum rent (highest first, excludes rents under $100)alphabetical: Sorts alphabetically by title (A-Z)menu_order: Sorts by WordPress menu order- Example:
[rentfetch_floorplans sort=beds] - Example:
[rentfetch_floorplans sort=availability]
- posts_per_page: Limits the number of floor plans displayed. Set to
-1to show all (default).- Example:
[rentfetch_floorplans posts_per_page=10]
- Example:
- taxonomy: Specifies a taxonomy to filter by (e.g., “floorplancategory” or “floorplantype”).
- Example:
[rentfetch_floorplans taxonomy=floorplancategory]
- Example:
- terms: Specifies the term(s) within the taxonomy to filter by. Used in conjunction with the taxonomy parameter. Accepts single terms or multiple terms (slug values) separated by commas.
- Example:
[rentfetch_floorplans taxonomy=floorplancategory terms=studio] - Example:
[rentfetch_floorplans taxonomy=floorplantype terms="one-bedroom,two-bedroom"]
- Example:
How It Works
The shortcode creates a responsive grid layout that displays floor plans based on the specified parameters. It uses a standard WordPress query with custom meta and taxonomy queries to filter the results.
- Query Building: Applies filters to the WP_Query arguments based on the provided attributes
- Grid Display: Outputs floor plans in a
.floorplans-simple-gridcontainer with individual floor plan items - Hooks: Fires actions
rentfetch_before_floorplans_simple_gridandrentfetch_after_floorplans_simple_gridfor customization - Post Classes: Applies filtered post classes for styling
Display Behavior
- Shows all published floor plans by default (ignores availability status)
- Displays floor plans in a grid format with hover effects for buttons
- Respects the specified sorting order
- Applies pricing display preferences (range vs. minimum) from settings
- Shows unit counts unless hidden in settings
- Applies visual styling for unavailable floor plans if enabled
Examples
Show ONLY 2- and 3-bedroom floor plans from two specific properties.
[rentfetch_floorplans property_id="p1234,p5678" beds="2,3"]
Show the 6 lowest-priced floor plans, sorted by minimum rent.
[rentfetch_floorplans sort=pricelow posts_per_page=6]