PHPackages                             jweiland/circular - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. jweiland/circular

ActiveTypo3-cms-extension[File &amp; Storage](/categories/file-storage)

jweiland/circular
=================

Organize your circular records incl. PDF download

6.0.7(1mo ago)04.1k↓35.7%[1 PRs](https://github.com/jweiland-net/circular/pulls)GPL-2.0-or-laterPHPCI passing

Since Mar 7Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/jweiland-net/circular)[ Packagist](https://packagist.org/packages/jweiland/circular)[ Docs](https://jweiland.net)[ RSS](/packages/jweiland-circular/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (6)Dependencies (15)Versions (19)Used By (0)

TYPO3 Extension `circular`
==========================

[](#typo3-extension-circular)

[![Packagist](https://camo.githubusercontent.com/5ee9b5be33b429cd91d7c89cc45211ab0e172179f41b8dc26888cb6c6cf0479c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d2d677265792e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/jweiland/circular/)[![Latest Stable Version](https://camo.githubusercontent.com/dbc467b23a812e93e49321231c5752e920f459430f6b2d312609b552978e0a41/68747470733a2f2f706f7365722e707567782e6f72672f6a7765696c616e642f63697263756c61722f762f737461626c652e7376673f7374796c653d666f722d7468652d6261646765)](https://extensions.typo3.org/extension/circular/)[![License](https://camo.githubusercontent.com/f4dd5cf9295a538ec41397d22040986217474d729feaab9a39f3b03a61744b1c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a7765696c616e642d6e65742f63697263756c61723f6c6162656c3d6c6963656e7365267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/jweiland/circular/)[![Total Downloads](https://camo.githubusercontent.com/60cd037375a95f27c3f10b241487717cc4a1f62b968689de67d10b11bd4319dd/68747470733a2f2f706f7365722e707567782e6f72672f6a7765696c616e642f63697263756c61722f642f746f74616c2e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/jweiland/circular/)[![Monthly Downloads](https://camo.githubusercontent.com/80f62652f5ad51c51e8abc5fe22befe3ac29247243dbceb3e374b0a57473a70d/68747470733a2f2f706f7365722e707567782e6f72672f6a7765696c616e642f63697263756c61722f642f6d6f6e74686c793f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/jweiland/circular/)[![TYPO3 13.4](https://camo.githubusercontent.com/afa776fc5e0d3171e58541b852215f62b33c4ba151d008b1794b0bd511fb9354/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31332e342d677265656e2e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d7479706f33)](https://get.typo3.org/version/13)

[![Build Status](https://github.com/jweiland-net/circular/actions/workflows/ci.yml/badge.svg)](https://github.com/jweiland-net/circular/actions/workflows/ci.yml/badge.svg)

Circular is an extension for TYPO3 CMS. It shows you a list of circular records incl. detail view.

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

[](#1-features)

- Create circular records
    - Assign PDF
    - Assign category
    - Assign department
- List view with pagebrowser
- Detail view with link to download the PDF

2 Usage
-------

[](#2-usage)

### 2.1 Installation

[](#21-installation)

#### Installation using Composer

[](#installation-using-composer)

The recommended way to install the extension is using Composer.

Run the following command within your Composer based TYPO3 project:

```
composer require jweiland/circular

```

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

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

Download and install `circular` with the extension manager module.

### 2.2 Minimal setup

[](#22-minimal-setup)

1. Include the static TypoScript of the extension.
2. Create a circular records on a sysfolder.
3. Assign plugin "Circular" on a page and select at least the sysfolder as startingpoint.

### FAQ

[](#faq)

#### I get an error while invoking mailer engine

[](#i-get-an-error-while-invoking-mailer-engine)

Error:

```
DirectMailTeam\DirectMail\Dmailer::ensureCorrectEncoding(): Argument #1 ($inputString) must be of type string, null given

```

`circular` creates recipient records from employee records of `telephonedirectory`. As `direct_mail` needs a `name` column defined here:

Support
-------

[](#support)

Free Support is available via [GitHub Issue Tracker](https://github.com/jweiland-net/circular/issues).

For commercial support, please contact us at [support@jweiland.net](support@jweiland.net).

```
return $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['direct_mail']['defaultRecipFields']

```

but `telephonedirectory` does not have such a column, that error message appears.

We can't change that configuration, as that may break your existing recipient configuration for `tt_address`, `fe_users` and others.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance91

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity72

Established project with proven stability

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

Recently: every ~34 days

Total

15

Last Release

43d ago

Major Versions

1.0.1 → 2.0.02019-07-31

2.0.0 → 3.0.12021-09-10

3.1.0 → 4.0.02023-03-01

4.0.0 → 6.0.02025-10-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/cb3188d5c1229a7c04958c000b853852b90f81036611ceff5b9641d8376bd06e?d=identicon)[jweiland.net](/maintainers/jweiland.net)

---

Top Contributors

[![froemken](https://avatars.githubusercontent.com/u/2532472?v=4)](https://github.com/froemken "froemken (44 commits)")[![hojalatheef](https://avatars.githubusercontent.com/u/144037456?v=4)](https://github.com/hojalatheef "hojalatheef (42 commits)")[![sfroemkenjw](https://avatars.githubusercontent.com/u/123929835?v=4)](https://github.com/sfroemkenjw "sfroemkenjw (39 commits)")[![Crontis](https://avatars.githubusercontent.com/u/13061515?v=4)](https://github.com/Crontis "Crontis (5 commits)")[![pascal20997](https://avatars.githubusercontent.com/u/1337769?v=4)](https://github.com/pascal20997 "pascal20997 (3 commits)")

---

Tags

TYPO3 CMStypo3circular

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jweiland-circular/health.svg)

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

###  Alternatives

[beechit/fal-securedownload

Secure download of assets. Makes it possible to secure FE use of assets/files by setting permissions to folders/files for fe\_groups.

37604.3k4](/packages/beechit-fal-securedownload)[causal/image_autoresize

Simplify the way your editors may upload their images: no complex local procedure needed, let TYPO3 automatically resize down their huge images/pictures on-the-fly during upload (or using a command for batch processing) and according to your own business rules (directory/groups). This will highly reduce the footprint on your server and speed-up response time if lots of images are rendered (e.g., in a gallery). Features an EXIF/IPTC extractor to ensure metadata may be used by the FAL indexer even if not preserved upon resizing.

19491.0k](/packages/causal-image-autoresize)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[hmmh/solr-file-indexer

Solr file indexer for Typo3

15239.8k3](/packages/hmmh-solr-file-indexer)[jweiland/events2

Events 2 - Create single and recurring events

2166.7k3](/packages/jweiland-events2)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)

PHPackages © 2026

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