PX Cargo is a Joomla 6 template for freight and logistics companies on the T4 Framework. This guide covers the quickstart, installing on an existing site, styles, logo, fonts and colours, the pages and their Cargo blocks, editing on the page, the quote and tracking form, news and authors, offices, the AcyMailing newsletter and upgrades.

PX Cargo ships with the demo site of a freight and logistics company: a home page, a Services page with four service pages (Road Freight, Ocean Freight, Air Freight, Warehousing), a Tracking page with a quote and tracking form, About Us, News and Contact. The page sections are PX Content modules you can edit on the page; news items are ordinary Joomla articles.

  • 2 template styles: Landing for the pages built from blocks, Default for news, contact and every other page.
  • T4 Framework: logo, fonts, colours, menu and layouts on one settings screen with a live preview.
  • 8 Cargo blocks for PX Content, in 14 styles.
  • Quote and tracking form block with your contact details.
  • News with author boxes, a sidebar and a Latest News module layout.
  • AcyMailing newsletter sign-up in the footer, styled to match.

Quick start in 5 steps

  1. Install the quickstart on your hosting.
  2. Put in your logo, fonts and brand colours.
  3. Change the texts and pictures of the blocks right on the page.
  4. Enter your offices and point the quote form to your own form or tracking page.
  5. Publish your own news and set the sender address of your newsletter.

What you can download:

PackageUse it when
QuickstartYou start a new site. It installs Joomla 6, the template, PX Content, AcyMailing and the demo content in one go.
TemplateYou add PX Cargo to a site you already have.
PX Content moduleNeeded with the template package. Already in the quickstart.
T4 Framework pluginVersion 2.6.5, needed with the template package. Already in the quickstart.

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

  1. Download the PX Cargo Quickstart from your account on thepixel.dev.
  2. Create an empty database and a database user on your hosting.
  3. Upload the zip to the folder where the site will live, and extract it.
  4. Open your domain in the browser. The Joomla installer starts.
  5. Fill in the site name, your admin account and the database details, then click Install Joomla.
  6. When the installer finishes, click Remove "installation" folder.

The quickstart already contains the T4 Framework, the PX Content module, AcyMailing and all demo pages and images. You do not need to install anything else. To get short URLs without index.php, rename htaccess.txt to .htaccess and turn on Use URL Rewriting in the Global Configuration.

Install on an existing site

Install the packages in this order through System » Install » Extensions » Upload Package File:

  1. T4 Framework plugin (the template needs it to run).
  2. PX Cargo template.
  3. PX Content module.

AcyMailing is optional: install it from acymailing.com if you want the newsletter form. A manual install gives you the template and its blocks, but not the demo pages: build them with PX Content modules in the positions listed in Pages and blocks.


StyleT4 layoutUsed for
px_cargo - LandinghomeHome, Services and the four service pages, Tracking, About Us: full-width pages built from blocks
px_cargo - DefaultdefaultNews, articles, Contact, search, login and every other page

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, Layouts and Global Settings, with a live preview.

Logo, fonts and colours

  • Site Settings » Logo: your logo and the small logo for phones (the demo files are templates/px_cargo/images/logo/cargo-logo.svg and cargo-mark.svg; cargo-logo-dark-bg.svg is the version for dark backgrounds).
  • Typography: the demo uses Jost for text and Cal Sans for headings.
  • Theme: the demo's primary colour is yellow #F6BF40 and its dark colour is navy #002E5B. Change these two and buttons, labels, the header and the dark sections follow.
PositionWhat the demo shows there
topbar-l, topbar-rCity, phone and address; opening hours, Help Center and social links (Custom modules)
header-rSearch and the Get a quote button
off-canvasThe menu on phones
footer-logo, footnav-1 … footnav-4, footerTagline, contacts, two menus, the newsletter form and the copyright line

Your own CSS

Use Tools » Edit Custom CSS for small design changes. Your CSS is kept when you update the template.


The Landing pages are built from PX Content modules. The banner of a page sits in the slideshow position and its sections in section-1 to section-13, in that order. Each module is assigned to its own page (Menu Assignment), so the same position shows different sections on different pages.

BlockStylesUsed in the demo for
Cargo Hero2The home page hero and the banners of the inner pages
Cargo Features3Intro cards, the services grid, the four-step process
Cargo Content3About and overview sections with a picture and a list, FAQ
Cargo Stats1The network map with four key figures
Cargo Showcase1Projects on the home page
Cargo CTA2The call-to-action band; the quote and tracking form
Cargo Testimonials1Customer reviews
Cargo Clients1Partner and client logos

To add a section, create a PX Content module, pick a Cargo block and a style, fill in the fields, choose a section-N position and assign it to the page. To build a new page, add a menu item of type Single Article (an empty article is fine), give it the px_cargo - Landing style and assign your modules to it. The quickest way to add a service is to duplicate the modules of an existing service page and assign the copies to the new menu item.

Edit texts on the page

  1. Log in on the site.
  2. Click Edit content at the bottom right of the page.
  3. Double-click a text to change it. Press Ctrl/⌘+Enter to save.
  4. Open Settings for the other options of a block, such as pictures, links and the style.
  5. Click Done when you are finished.

Quote and tracking form

The form is the Cargo CTA block in style 2. It has a Quote tab (from, to, freight type, weight, email) and a Track tab (tracking number), with your address, phones and emails beside it. Tab names, placeholders and button texts are fields of the block.

The block does not send email or look up shipments by itself. It passes what the visitor typed to the page set in Form link (the demo points to the Tracking page). Point it to a page with your form extension, or to the tracking page of your transport system, and read the values there (tracking is the name of the tracking number field).


  • News is a Category Blog menu item of the News category; Road Freight, Ocean & Air, Warehousing and Industry News are its child categories. Rename them or add your own.
  • The sidebar-blog position holds search, categories, recent posts, tags and a quote box beside the list and the articles.
  • The Latest News section on the home page is an Articles module with the cargo-news layout (Advanced » Layout); choose the category and the number of articles on its Module tab.
  • An article shows its intro image as a wide banner with the category, title, date and author.

Authors

The author box under an article comes from the article's author. Give each writer a Joomla user and fill in their profile: avatar, job title and About Me. The four demo authors are blocked users that cannot log in; replace them with your own, or set your articles' author to yourself.

Offices and the Contact page

The Contact page is a Joomla contact (Components » Contacts). The demo has a head office and three branches; edit them, or add a contact for each of your offices. The address, phones and emails shown in the top bar, the footer and the quote form are texts of their own modules: change them there too.


The sign-up form in the footer is an AcyMailing subscription module in footnav-4. Before you send anything, open Components » AcyMailing » Configuration, set your From and Reply to addresses (the quickstart uses This email address is being protected from spambots. You need JavaScript enabled to view it.) and the sending method, then send yourself a test.


Can PX Cargo track real shipments?

Not by itself. The tracking form passes the tracking number to a page you choose; the look-up is done by your transport or carrier system. See Quote and tracking form.

How do I add a new service page?

Add a menu item under Services with the px_cargo - Landing style, duplicate the banner, overview, benefits, process and call-to-action modules of an existing service and assign the copies to the new menu item. Then change the texts on the page.

Do I need AcyMailing?

No. Unpublish the newsletter module in the footer if you do not send a newsletter.

Does PX Cargo work with Joomla 5?

No. PX Cargo 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.


When a new version is out, Joomla shows it under System » Update » Extensions. Download the new Template package from your account on thepixel.dev and install it over the current one through System » Install » Extensions. Your content, modules, template settings and Custom CSS stay. Install a newer T4 Framework plugin or PX Content module only when the release notes ask for it.