PHPackages                             mklocke/docnamic - 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. [Templating & Views](/categories/templating)
4. /
5. mklocke/docnamic

ActiveLibrary[Templating & Views](/categories/templating)

mklocke/docnamic
================

The document template engine

347.2k↓47.2%3[1 issues](https://github.com/mariusklocke/docnamic/issues)PHP

Since Oct 15Pushed 8y ago1 watchersCompare

[ Source](https://github.com/mariusklocke/docnamic)[ Packagist](https://packagist.org/packages/mklocke/docnamic)[ RSS](/packages/mklocke-docnamic/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Docnamic - The document template engine
=======================================

[](#docnamic---the-document-template-engine)

Docnamic is a template engine for OpenDocument files (\*.odt) based on PHP's DOM and ZIP extensions. My goal is to provide a simple document generation library whose templates can be easily created using standard WYSIWYG OpenDocument software. I am interested if this library is useful for anybody out there and i will appreciate any feedback on Github or via email.

Please note that the public API should not be considered stable yet.

I will add tests once i am sure about the internal class interfaces.

Requirements
------------

[](#requirements)

- PHP 5.6 or later
- DOM extension
- ZIP extension

Installation
------------

[](#installation)

Install this library via composer.

```
$ composer require mklocke/docnamic
```

Usage
-----

[](#usage)

Have a look at the folder `examples` which contains examples of how the library should be used.

```
$renderer = new Renderer();
$renderer->loadTemplate('template.odt')
         ->setData(['foo' => 'bar'])
         ->render('result.odt');
```

Convert to PDF
--------------

[](#convert-to-pdf)

The resulting OpenDocument files can be easily converted to PDF using the `unoconv` CLI tool on most linux distributions.

Installation on Ubuntu: `sudo apt-get install unoconv`

Convert a ODT file to PDF: `unoconv -f pdf -o result.pdf result.odt`

FAQ
---

[](#faq)

- Can i use barcodes or QR Codes?

    Yes, you can by using barcode fonts in your document template. OpenDocument files can have embedded fonts. If you use LibreOffice for creating your document templates, read their help pages regarding [Embedding Fonts](https://help.libreoffice.org/Common/Embedding_Fonts)
- Can i use nested loops in my document template?

    No, for now nested loops are not supported.
- Can i use dynamic images?

    No, dynamic images are not supported yet.
- What about encodings?

    As OpenDocument is a UTF-8-based XML file format, your data should be UTF-8 encoded as well ;)
- What about i18n or l10n?

    As this is a rather simple template engine, it has no notion of languages, countries or currencies. This has be taken care of the integrating application.

Inspired by
-----------

[](#inspired-by)

- [Secretary](https://github.com/christopher-ramirez/secretary)
- [docxtemplater](https://github.com/open-xml-templating/docxtemplater)

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/3683d6901a5292d4f3186d0cc48df74a220ec15dc77f35ac56cdd93c95dd3313?d=identicon)[mklocke](/maintainers/mklocke)

---

Top Contributors

[![mariusklocke](https://avatars.githubusercontent.com/u/7437495?v=4)](https://github.com/mariusklocke "mariusklocke (1 commits)")

---

Tags

odtopendocumenttemplatestemplating

### Embed Badge

![Health badge](/badges/mklocke-docnamic/health.svg)

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

###  Alternatives

[limenius/react-bundle

Client and Server-side react rendering in a Symfony Bundle

3851.2M](/packages/limenius-react-bundle)[area17/laravel-auto-head-tags

Laravel Auto Head Tags helps you build the list of head elements for your app

4616.1k](/packages/area17-laravel-auto-head-tags)[jelix/wikirenderer

WikiRenderer is a library to generate HTML or anything else from wiki content.

1712.3k1](/packages/jelix-wikirenderer)[webkinder/sproutset

A Composer package for handling responsive images in Roots Bedrock + Sage + Blade projects.

282.2k](/packages/webkinder-sproutset)

PHPackages © 2026

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