PX Magz is a Joomla 6 magazine template on the T4 Framework. This guide covers the quickstart, installing on an existing site, styles, fonts and colours, the front page and its story list layouts, sections, photo stories, podcasts and writers, the PX Content blocks, AcyMailing newsletters and upgrades.
Overview
PX Magz ships with the demo site of a weekly magazine: a front page, nine sections with their subsections (World, Culture, Food & Drink, Ideas, Nature, Home & Style, Health, Travel, Sport), photo stories, podcasts, writers, newsletters and more than 220 stories. Stories are ordinary Joomla articles in categories; the page sections are modules you can edit.
- 4 template styles: front page, sections, articles and plain pages.
- T4 Framework: logo, fonts, colours, megamenu and layouts on one settings screen with a live preview.
- 20 story list layouts for article modules and 9 article layouts.
- 6 PX Content blocks made for this template: issue cover, adverts, events, people, newsletter, social links.
- Fields for section colours, galleries, videos, podcasts and author profiles.
- AcyMailing newsletter sign-ups, styled to match.
Quick start in 5 steps
- Install the quickstart on your hosting.
- Put in your logo and brand colour.
- Rename the sections (categories) to yours and give each its accent colour.
- Add your writers as users with a profile, then publish your own stories.
- Set the sender address of your newsletters.
What you can download:
| Package | Use it when |
|---|---|
| Quickstart | You start a new site. It installs Joomla 6, the template, PX Content, AcyMailing and the demo content in one go. |
| Template | You add PX Magz to a site you already have. |
| PX Content module | Needed with the template package. Already in the quickstart. |
| T4 Framework plugin | Version 2.6.5, needed with the template package. Already in the quickstart. |
Installation
System requirements
- Joomla 6.x
- PHP 8.3 or later
- MySQL 8.0.13+ or MariaDB 10.4+
- Apache 2.4+ or Nginx 1.21+
Install the quickstart
- Download the PX Magz Quickstart from your account on thepixel.dev.
- Create an empty database and a database user on your hosting.
- Upload the zip to the folder where the site will live, and extract it.
- Open your domain in the browser. The Joomla installer starts.
- Fill in the site name, your admin account and the database details, then click Install Joomla.
- When the installer finishes, click Remove "installation" folder.
The quickstart already contains the T4 Framework, the PX Content module, AcyMailing and all demo stories and images. You do not need to install anything else.
Install on an existing site
Install the packages in this order through System » Install » Extensions » Upload Package File:
- T4 Framework plugin (the template needs it to run).
- PX Magz template.
- PX Content module.
AcyMailing is optional: install it from acymailing.com if you want the newsletter form. A manual install gives you the template, but not the demo stories and modules: build your pages with the steps in Set up your pages.
Template styles and settings
| Style | T4 layout | Used for |
|---|---|---|
| px_magz - Landing | home | The front page |
| px_magz - Section | section | The nine section pages |
| px_magz - Default | default | Articles, subsections, In Pictures, Podcasts (every page without its own style) |
| px_magz - Page | no-sidebar | About, Writers, Newsletters, legal pages and the account pages |
Choose the style of a page in its menu item (Template Style on the Details tab). Open a style to reach the T4 settings: Site Settings, Navigation, Theme Color, Layouts and Global Settings, with a live preview.
Logo, fonts and colours
- Site Settings » Logo Settings: your logo (the demo logo is
templates/px_magz/images/logo/px-magz-logo.svg). - Typography: the demo uses Archivo for text and Newsreader for headings; a section can switch its headings with the Heading voice field.
- Theme Color: the brand red of buttons and the ink and paper tones. Each section can override its accent, see Sections.
Your own CSS
Use Tools » Edit Custom CSS for small design changes. Your CSS is kept when you update the template.
Front page and module positions
The front page is built from modules. Most are Articles modules with a PX Magz layout (Advanced » Layout), so they fill themselves from your stories.
| Position | What the demo shows there |
|---|---|
topbar-l, topbar-r, masthead-l, header-r | Dateline and issue, sign in / sign up, masthead note, Subscribe button |
mega-world … mega-sport | The mega menu of each section (layout mega) |
ticker | “World now” ticker (layout ticker) |
lead, lead-aside, latest | Top stories, Most popular, The Morning Edit, Latest news |
world, culture … sport | One band per section, each with its own list layout |
issue, week-ahead, podcasts, writers, promo-1 … promo-3 | This week's issue, events, podcasts, writers, promotions |
ad-leader, health-aside, sidebar-r | Adverts; the article sidebar (advert, newsletter) |
footer-logo, footnav-1 … footnav-5, footer | Footer: about, menus, newsletter, legal, copyright |
Story list layouts
Articles modules can use these layouts: lead, latest, popular, ticker, slider, mega, more and the section layouts cat-live, cat-mosaic, cat-feature, cat-wall, cat-scroller, cat-columns, cat-center, cat-side, cat-tiles, cat-spot, cat-spot-stack, cat-desk, cat-four, cat-photos. Choose the category, number of stories and ordering on the module's Module tab.
Sections, stories and writers
- Sections are top-level categories with a Category Blog menu item and the Section style; subsections are child categories. In the category's Fields tab, Accent colour sets the section colour used by labels and lines; Page tone and Featured arrangement change the section page.
- The All stories menu items use the
riverlayout: every story of a section, newest first. - In Pictures uses the
photoslayout; a photo story fills the Photo gallery field (photo and description per frame). - Podcasts uses the
podcastslayout; an episode fills Show, Episode and Length (minutes). - A story with a YouTube or Vimeo link in its Video URL field shows the player at the top.
- Each story can use another article layout (cover, poster, split, photo, inline, left, type) in its Options » Layout.
Writers
Bylines come from the article's author. Give each writer a Joomla user with the Role, Bio and Portrait fields filled in (Users » Manage » Fields): they show in the author box under each story and on the Our writers page. The demo writers are blocked users that cannot log in; replace them with your own.
PX Content blocks and editing on the page
| Block | Styles | Used in the demo for |
|---|---|---|
| Issue | 1 | This week's issue: cover, theme and stories |
| Ad | 1, 2, 3 | Typographic and photo adverts |
| Events | 1 | The Week Ahead, as tear-off calendar pages |
| People | 1 | Our Writers row |
| Newsletter | 1 | Newsletter sign-up card |
| Social | 1 | Social links |
Edit texts on the page
- Log in on the site.
- Click Edit content at the bottom right of the page.
- Double-click a text to change it. Use the small toolbar for bold, italic and underline. Press Ctrl/⌘+Enter to save.
- Pick a new picture from the Media Manager, or open Settings for the other options of a block.
- Click Done when you are finished.
Frequently asked questions
How do I add a new section?
Create a category (and child categories), a Category Blog menu item with the Section style, and copy the section modules of an existing section to it, assigned to the new menu item. Add a mega-… module for its mega menu.
Do I need AcyMailing?
No. Unpublish the newsletter modules and the Subscribe button if you do not send newsletters.
Does PX Magz work with Joomla 5?
No. PX Magz is made for Joomla 6 and needs PHP 8.3 or later.
My changes do not show on the site. What do I do?
Clear the cache in System » Clear Cache and reload the page.
Where can I get help?
Ask in the ThePixel forum. Tell us your Joomla and PHP versions and the page where you see the problem.