Everything you need to set up JR Prism. This guide walks you from install to a published showcase — choosing a layout, pulling in your content, tuning the display, styling it to match your template, and keeping the module up to date. Features marked (Pro) are available in the Pro edition.
On this page
- Requirements
- Installation
- Quick start — your first showcase
- Choosing a layout
- Content sources
- The items manager
- Display settings
- Styling & theming
- Keeping JR Prism updated
- Upgrading from Lite to Pro
- Troubleshooting
- FAQ
Requirements
- Joomla 5.x or 6.x
- PHP 8.2 or newer
- A site template built on Bootstrap 5 (the default Joomla templates Cassiopeia and Atum both qualify)
Installation
- Download the package zip — Lite from the Joomla Extensions Directory, or Pro from your joomreem.com account after purchase.
- In the Joomla administrator, go to System → Install → Extensions.
- Drag the zip onto the Upload & Install area (or browse to it). Joomla confirms a successful install.
- Go to Content → Site Modules (or System → Site Modules), click New, and choose JR Prism.
That's it — you now have a JR Prism module instance ready to configure. You can add as many instances as you like, each with its own layout, content source, and position.
Quick start — your first showcase
- Open your new JR Prism module.
- Give it a Title and assign a Position on the Module tab (e.g. a position in your template's main content area).
- On the Module tab, pick a Layout under Advanced → Module Layout (or the layout selector) — see Choosing a layout below.
- Set the Source Type and add your items — see Content sources.
- Choose where it appears under Menu Assignment, set status to Published, and Save.
- View your site — the showcase renders in the position you chose, styled by your template.
Choosing a layout
Pick one layout per module instance — switch any time, no rebuild. Set it under the module's Advanced tab (Module Layout).
| Layout | What it's for |
|---|---|
| Card grid (default) | A clean, responsive grid of cards. Set how many per row with Items per row. |
| Accordion | Collapsible panels — ideal for FAQs, feature lists, and long content. |
| Carousel (Pro) | A split-panel showcase slider with autoplay, animation, and touch-swipe. |
| Mosaic (Pro) | A CSS-grid gallery with elegant hover overlays. |
| Tabs | Bootstrap 5 tabbed panels for organising content by topic. |
| Scroller | A scrolling headline list synced to a content preview panel. |
Content sources
Set Source Type on the module's basic settings. The fields below it change to match your choice.
Articles
Hand-pick individual Joomla articles. Use the built-in items manager to add articles, drag to reorder, and (optionally) override any item's title, image, description, or link — handy when you want the showcase to read differently from the source article.
Simple (manual items)
Build a custom list by hand in the items manager — each entry has its own title, image, description, and link, with no underlying Joomla article required. Perfect for promo tiles, service lists, or curated link sets. Drag to reorder; edit inline.
Category (Pro)
Pull articles dynamically from one or more categories. New articles in those categories appear automatically — no manual updates. Options:
- Categories — select one or more com_content categories.
- Include child categories — also pull from sub-categories.
- Limit — cap how many items show (0 = no limit).
The items manager
For the Articles and Simple sources, items are managed inline in the module settings:
- Add items one at a time (paged, 10 per page).
- Drag-and-drop to reorder — the order is your display order when Sort is set to Manual.
- Per-item overrides — open any item to set a custom title, image, description, or link that replaces the source values for that card only.
Display settings
The Display tab controls what each item shows and how the showcase behaves. Full reference:
| Setting | What it does | Default |
|---|---|---|
| Show title | Show or hide each item's title. | On |
| Show image | Show or hide each item's image. | On |
| Show description | Show or hide each item's description text. | On |
| Intro text limit | Maximum characters of description to show (0 = no limit). | 150 |
| Allow HTML in description | Render HTML in descriptions instead of plain text. | Off |
| Items per row | Cards per row in the grid layout (1–6). | 3 |
| Items per page | Show this many at first, then reveal more (0 = show all). | 0 |
| Sort (Pro) | Order items by Manual, Date, Title (A–Z), Hits, or Random. | Manual |
| Sort direction (Pro) | Ascending or descending (for Date / Title / Hits). | Descending |
| Autoplay (Pro) | Auto-advance the carousel. | Off |
| Autoplay delay (Pro) | Milliseconds between slides (min 1000). | 5000 |
| Pause on hover (Pro) | Pause autoplay while the cursor is over the carousel. | On |
| Animation (Pro) | Carousel transition: Fade, Slide, or None. | Fade |
| Touch swipe (Pro) | Allow swipe gestures on touch devices. | On |
Note: autoplay, animation, pause-on-hover, and touch-swipe apply to the Carousel layout; Items per row applies to the grid.
Styling & theming
- Inherits your template — JR Prism uses Bootstrap 5 variables, so colours and fonts come from your active template out of the box. No clashing brand colours.
- Fine-tune with one variable — override a single Bootstrap CSS variable in your template if you want to nudge a colour.
- Module Class Suffix — add a CSS class under the Advanced tab to target a specific instance with your own styles.
- Responsive by default — every layout adapts from desktop to phone; images lazy-load for speed.
Keeping JR Prism updated
Both editions update through Joomla's normal Update system — no extra tools.
Lite
Lite updates are public. When a new version ships, Joomla shows it under System → Update → Extensions; click to update. Nothing to configure.
Pro — enter your Download ID once
- Copy your Download ID from your joomreem.com account.
- In Joomla, go to System → Update → Update Sites.
- Find JR Prism Pro, open it, paste your Download ID into the Download Key field, and save.
- Joomla now pulls Pro updates automatically through our secure update server.
You only do this once per site. The module keeps working whether or not your subscription is active (it's GPL) — an active subscription is what delivers ongoing updates and priority support.
Upgrading from Lite to Pro
Install the Pro package over the top of Lite — Joomla upgrades in place and your existing module instances, settings, and items are preserved. After upgrading you'll see the premium layouts (Carousel, Mosaic), the dynamic Category source, and the advanced display controls unlock. Then add your Download ID (above) so Pro updates flow.
Troubleshooting
The module doesn't appear on my site.
Check it's Published, assigned to a Position your template actually renders, and included in the page's Menu Assignment.
Colours look off / don't match my template.
JR Prism inherits Bootstrap 5 variables. If your template doesn't define them, set a Module Class Suffix and add a small CSS override, or switch to a Bootstrap-5 template.
Images aren't showing.
Make sure each item has an image set (or, for articles, an intro/full image), and that Show image is on.
Category source isn't listed.
The dynamic Category source is a Pro feature — confirm you're running the Pro edition.
Pro updates aren't offered.
Confirm your Download ID is saved under System → Update → Update Sites → JR Prism Pro, and that your subscription is active.
FAQ
Does JR Prism work on Joomla 5 and 6?
Yes — both, natively.
Can I run more than one showcase on a page?
Yes. Create as many JR Prism module instances as you like, each with its own layout, source, and position.
Will upgrading to Pro lose my settings?
No — Pro installs over Lite in place and keeps your instances, settings, and items.
Is Lite really free?
Yes — JR Prism Lite is free and GPL-licensed on the Joomla Extensions Directory, with no time limit and no feature nag.
Is it secure?
Yes — JR Prism was security-reviewed: inputs are filtered, and admin actions use a session-scoped token rather than a permanent credential.
Need more?
Start free with Lite, or unlock every layout and the dynamic Category source with Pro — one price, all your sites.