OpenCart Extension Development

Overview

OpenCart is an open-source PHP e-commerce platform built on a strict MVC (Model-View-Controller) architecture with a clear separation between the admin (back-office) and catalog (storefront) sides. Extensions modify or extend platform behavior without altering core files, using one of three mechanisms: the OCMOD XML modification system, the event/hook system (OpenCart 3.x+), or standalone MVC extensions that add entirely new controllers, models, and views.

OpenCart 4.x introduced namespaced PHP classes, Twig as the default template engine (replacing the older PHP-based .tpl files), and a modernized extension installer. Despite these changes, the fundamental architecture remains the same: every request routes through a controller, which loads models for data access and renders a view for output.

Develop extensions by creating files within the extension/ directory structure (OC4) or the upload/ overlay structure (OC3), following the platform's naming and routing conventions exactly. Deviating from these conventions causes silent failures because OpenCart's autoloader and routing engine depend on directory paths matching controller class names.

Extension Types

OpenCart organizes extensions into categories, each with a specific purpose and integration point: