PHPackages                             slavlee/advertising - 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. slavlee/advertising

ActiveTypo3-cms-extension

slavlee/advertising
===================

The best advertising extension for TYPO3 to monetarize you TYPO3 webpage.

1.0.0(2y ago)131[1 issues](https://github.com/slavlee/advertising/issues)GPL-2.0-or-laterSCSS

Since Dec 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/slavlee/advertising)[ Packagist](https://packagist.org/packages/slavlee/advertising)[ RSS](/packages/slavlee-advertising/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

TYPO3 Extension `advertising`
=============================

[](#typo3-extension-advertising)

[![TYPO3 11](https://camo.githubusercontent.com/5432de37ab8517e6d9e6f803a2e1a7674a308c6d93896fe8a6fbc8a4cb50aece/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31312d6f72616e67652e737667)](https://get.typo3.org/version/11) [![Donate](https://camo.githubusercontent.com/604e3db9c8751116b3f765aad0353ec7ded655bbe8aaacbc38d8c4a6b784b3ed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d50617950616c2d677265656e2e737667)](https://www.paypal.me/slavlee/5)

Advertising is a native TYPO3 extension without any dependencies. Create advertising campaigns for you or your customers and post them on your TYPO3 page. It is as easy as to publish an image element.

1 Features
----------

[](#1-features)

- Native TYPO3 Extension, no external service required
- 100% GDPR compliance (no cookies, no profiling, no personal data is tracked or processed)
- View statistic metrics as a backend module (Delivered, Clicked, Click-Through-Rate)
- Embed individual banner
- Embed a zone which shows the assigned banner in a random way
- Set start- and end date and time of your campaigns

2 Usage
-------

[](#2-usage)

### 2.1 Installation

[](#21-installation)

#### Installation as extension from TYPO3 Extension Repository (TER)

[](#installation-as-extension-from-typo3-extension-repository-ter)

Download and install the [extension](https://extensions.typo3.org/extension/advertising) with the extension manager module.

### 2.2 Minimal setup

[](#22-minimal-setup)

1. Create a new folder and name it as you want
2. Edit this sysfolder and go to **Behaviour** and choose the Advertising plugin
3. Go to the **Resources** tab and choose **Page TSConfig**: EXT:advertising and save the folder
4. Edit your root page template and go to the **Includes tab** and choose the EXT:advertising static file.
5. Go to the Admin Tools: **Settings** and click on **Configure extensions**. Edit there the **Storage Page** for the extension: **advertising**
6. Now you are ready to create customers, campaign, zones and banners inside the new folder you have created in step 1

### 2.3 Recommended settings

[](#23-recommended-settings)

#### Route Enhancer

[](#route-enhancer)

Set custom routes for the typeNum values set in step 5 (see list above). I recommend the following settings: routeEnhancers: PageTypeSuffix: type: PageType \[...\] map: \[...\] '/clicktracking': 28062019 '/deliveredtracking': 28062020

3 How do you should use this extension
--------------------------------------

[](#3-how-do-you-should-use-this-extension)

Before you create your first banner, go to the created sysfolder and create there at least one customer and campaign. Every banner needs to be assigned to a customer and a campaign. If you don't have a customer, then create an customer entity for yourself.

The zones are optional, because you also can create individual banners on your TYPO3 page. You will find the banner and zone in the content element browser.

### 3.1 Campaign

[](#31-campaign)

A campaign holds the information to decide if an advertising material shall be displayed in the frontent. For the moment you can set start- und endtime. You can also let them empty, then your campaign is always active.

### 3.2 Customer

[](#32-customer)

A customer is just a name and groups the campaigns and banners to a person or organization. It is used to give you the opportunity to sell advertising spots on your website for your customers.

### 3.3 Zone

[](#33-zone)

A zone is a content element which shows only one banner at a time. If multiple banners are assigned to this zone and have active campaigns, then it will take randomly one banner from the list. At the moment there are no priorizations, but they will come in future releases.

### 3.4 Banner

[](#34-banner)

A banner is the only advertising material you can take at the moment, but they will come more in future releases. A Banner is just a image with a link behind it. Every appearance on the website and click will be tracked with asynchronous JavaScript.

4 Display statistics
--------------------

[](#4-display-statistics)

There is a new backend module for admins: Advertising. This module shows a dashboard with all available statistic data for campaigns and their banners. At the moment the extension only shows the following data:

- delivered (increment when banner is display in the frontend)
- clicked (increment when user clicked on the banner)
- Click-Through-Rate (CTR). Factor of clicked/delivered.

5 Tracking
----------

[](#5-tracking)

The tracking is done with a asynchronous JavaScript. It is not perfect but the best solution. It can happen in different circumstances, that advertising misses a delivered or clicked event. This usually can happen, when:

- User left the page quicker than the script loads
- User clicked on an advertising material quicker than the script loads

That's why the data is not 100% accurate, but it is a very good guess.

6 Changelog
-----------

[](#6-changelog)

The changelogs can be found inside the CHANGES.md file.

### 6.1 Release Management

[](#61-release-management)

Advertising uses [**semantic versioning**](https://semver.org/), which means, that

- **bugfix updates** (e.g. 1.0.0 =&gt; 1.0.1) just includes small bugfixes or security relevant stuff without breaking changes,
- **minor updates** (e.g. 1.0.0 =&gt; 1.1.0) includes new features and smaller tasks without breaking changes,
- and **major updates** (e.g. 1.0.0 =&gt; 2.0.0) breaking changes wich can be refactorings, features or bugfixes.

Having this said, I **highly recommend** to make a update from your whole webpage before upgrading advertising to any version.

Thanks to my contributors
-------------------------

[](#thanks-to-my-contributors)

- Dmitry Dulepov

Explore more
------------

[](#explore-more)

If you are looking for awesome and easy to use TYPO3 templates and extensions, then visit: [T3 Templates](https://t3templates.de/en/products)

7 Final words
-------------

[](#7-final-words)

I give my best to make this extension as accurate and as reliable as I can. Unfortunately I can't promise or guarantee that the tracking will always be working. Also, there are a lot of external potentials that this extension can't work. For example JavaScript tend to stop working and certain error types.

That's why I can not take any responsibilities of problems you may walk into, when this extension does not perform at all or creating false data.

All I can is to give my very best to make this extension as best as I can.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance6

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.7% of commits — single point of failure

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 ~104 days

Total

2

Last Release

785d ago

Major Versions

0.19.0 → 1.0.02024-03-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/cff6d8de81f82ccdd6ede8c23365e36c3fc643a7835991a24129e72c9cc61777?d=identicon)[slavlee](/maintainers/slavlee)

---

Top Contributors

[![slavlee](https://avatars.githubusercontent.com/u/40547171?v=4)](https://github.com/slavlee "slavlee (36 commits)")[![dmitryd](https://avatars.githubusercontent.com/u/306133?v=4)](https://github.com/dmitryd "dmitryd (2 commits)")

### Embed Badge

![Health badge](/badges/slavlee-advertising/health.svg)

```
[![Health](https://phpackages.com/badges/slavlee-advertising/health.svg)](https://phpackages.com/packages/slavlee-advertising)
```

###  Alternatives

[fluidtypo3/vhs

This is a collection of ViewHelpers for performing rendering tasks that are not natively provided by TYPO3's Fluid templating engine.

1954.1M49](/packages/fluidtypo3-vhs)[in2code/powermail

Powermail is a well-known, editor-friendly, powerful and easy to use mailform extension for TYPO3 with a lots of features

982.5M38](/packages/in2code-powermail)[typo3/testing-framework

The TYPO3 testing framework provides base classes for unit, functional and acceptance testing.

675.0M775](/packages/typo3-testing-framework)[fluidtypo3/flux

The flux package from FluidTYPO3

152982.2k20](/packages/fluidtypo3-flux)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

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