PHPackages                             o3-shop/o3-theme - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. o3-shop/o3-theme

ActiveO3shop-theme[Utility &amp; Helpers](/categories/utility)

o3-shop/o3-theme
================

Responsive Theme for O3-Shop

v1.5.2(2d ago)02.1k↑144.6%31GPL-3.0-onlySmartyCI passing

Since Apr 22Pushed yesterday1 watchersCompare

[ Source](https://github.com/o3-shop/o3-Theme)[ Packagist](https://packagist.org/packages/o3-shop/o3-theme)[ Docs](https://www.o3-shop.com/)[ RSS](/packages/o3-shop-o3-theme/feed)WikiDiscussions main Synced yesterday

READMEChangelog (9)Dependencies (5)Versions (25)Used By (1)

O3-Theme
========

[](#o3-theme)

Responsive theme for O3-Shop, built on Bootstrap 5.

Overview
--------

[](#overview)

O3-Theme is the official responsive theme for O3-Shop. It provides a full Bootstrap 5 frontend including compiled CSS/JS, Smarty templates, translations, and a complete set of theme settings configurable via the shop admin.

Current version: **1.5** — see [CHANGELOG.md](CHANGELOG.md) for what changed.

---

Directory layout
----------------

[](#directory-layout)

```
o3-theme/
├── build/          SCSS + JS source files (entry point: main.bundle.scss / main.bundle.js)
├── out/o3-theme/
│   └── src/
│       ├── css/    main.css, main.min.css, photoswipe.css
│       ├── js/     main.js, main.min.js, widget/*.js
│       ├── img/    theme images and background
│       └── fonts/  web fonts
├── tpl/            Smarty templates (layout, pages, widgets, email, forms)
├── de/             German translations (lang.php, theme_options.php)
├── en/             English translations (lang.php, theme_options.php)
├── theme.php       Theme metadata, version, and all configurable settings
├── setup.sql       Default config values (legacy; Theme::activate() handles this on O3-Shop 1.6+)
├── composer.json   Composer package metadata
├── CHANGELOG.md    Version history
└── README.md       This file

```

---

CSS build
---------

[](#css-build)

The build toolchain requires Node.js ≥ 22.13 and Gulp CLI ≥ 3.

```
npm install          # install dependencies once
gulp                 # production build (minified, PurgeCSS)
gulp dev             # watcher for day-to-day development
```

`gulp dev` also clears the shop's Smarty `tmp/` on template and translation changes. Run the shop in dev mode (admin → Theme settings → disable production mode) while developing so the browser loads unminified assets.

To rebuild only the CSS without the full gulp pipeline:

```
cd out/o3-theme/src/css
npx sass --style=compressed --no-source-map main.css main.min.css
```

---

Child themes
------------

[](#child-themes)

O3-Theme is designed to be extended via child themes. Set `parentTheme => 'o3-theme'`in the child theme's `theme.php`. O3-Shop resolves templates and assets from the child theme first, then o3-theme, so only files that actually differ need to be present in the child theme.

---

Clearing the Smarty cache
-------------------------

[](#clearing-the-smarty-cache)

```
docker exec  bash -c "rm -rf /var/www/html/source/tmp/smarty/"
```

---

Issues
------

[](#issues)

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance100

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~27 days

Recently: every ~7 days

Total

17

Last Release

2d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/53b105106ade5f151851db1839b344f7be04f17d881c49ca0f4da0867d5b2d82?d=identicon)[o3-shop](/maintainers/o3-shop)

---

Top Contributors

[![ralftrapp](https://avatars.githubusercontent.com/u/74130839?v=4)](https://github.com/ralftrapp "ralftrapp (31 commits)")[![nlo-tronet](https://avatars.githubusercontent.com/u/206915827?v=4)](https://github.com/nlo-tronet "nlo-tronet (27 commits)")[![maexware-daniel](https://avatars.githubusercontent.com/u/59417594?v=4)](https://github.com/maexware-daniel "maexware-daniel (25 commits)")[![egate-media-Frank](https://avatars.githubusercontent.com/u/9710002?v=4)](https://github.com/egate-media-Frank "egate-media-Frank (10 commits)")[![mzanier](https://avatars.githubusercontent.com/u/5287214?v=4)](https://github.com/mzanier "mzanier (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![swinde](https://avatars.githubusercontent.com/u/3349884?v=4)](https://github.com/swinde "swinde (1 commits)")

---

Tags

themeseshopO3-Shop

### Embed Badge

![Health badge](/badges/o3-shop-o3-theme/health.svg)

```
[![Health](https://phpackages.com/badges/o3-shop-o3-theme/health.svg)](https://phpackages.com/packages/o3-shop-o3-theme)
```

###  Alternatives

[sylius/theme-bundle

Themes management for Symfony projects.

1038.6M37](/packages/sylius-theme-bundle)[oxid-esales/apex-theme

APEX Theme

19137.2k9](/packages/oxid-esales-apex-theme)[ddoe/wysiwyg-editor-module

Summernote WYSIWYG Editor for OXID eShop.

191.0M5](/packages/ddoe-wysiwyg-editor-module)[oxid-esales/gdpr-optin-module

This is the GDPR opt-in module for the OXID eShop.

20473.8k3](/packages/oxid-esales-gdpr-optin-module)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
