PHPackages                             tualo/pkpass - 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. tualo/pkpass

ActiveLibrary

tualo/pkpass
============

tualo - pkpass

1.0.5(3mo ago)021MITPHP

Since Jul 3Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/tualo/pkpass)[ Packagist](https://packagist.org/packages/tualo/pkpass)[ RSS](/packages/tualo-pkpass/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (6)Used By (0)

Tualo Office - PKPass
=====================

[](#tualo-office---pkpass)

Eine PHP-Bibliothek zur Erstellung von Apple Wallet Passes (PKPass) für Tualo Office.

Beschreibung
------------

[](#beschreibung)

Dieses Modul ermöglicht die Generierung von Apple Wallet Passes (z.B. Event-Tickets, Boarding-Pässe, Coupons) direkt aus Tualo Office heraus. Es nutzt die Apple PassKit API und erstellt signierte .pkpass Dateien, die auf iOS-Geräten in der Wallet-App gespeichert werden können.

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

[](#installation)

```
composer require tualo/pkpass
```

Funktionen
----------

[](#funktionen)

- Erstellung von Apple Wallet Event-Tickets
- Automatische Signierung mit Apple Zertifikaten
- QR-Code Integration für Ticket-Validierung
- Konfigurierbare Farben und Branding
- Unterstützung für Icons, Logos und Hintergrundbilder
- Dynamische Felder für Ticket-Informationen
- Integration mit Tualo Office DS-Files System

Konfiguration
-------------

[](#konfiguration)

Das Modul benötigt folgende Umgebungsvariablen in der Datenbank-Tabelle `pkpass_environment`:

### Erforderliche Apple Zertifikate

[](#erforderliche-apple-zertifikate)

- `apple_certificate` - Pass Certificate (.p12)
- `apple_cert_pass` - Passwort für das Zertifikat
- `apple_wwdr_certificate` - Apple WWDR Certificate (.cer)

### Apple Pass Identifikation

[](#apple-pass-identifikation)

- `apple_passTypeIdentifier` - Pass Type Identifier
- `apple_teamIdentifier` - Team Identifier
- `apple_organizationName` - Organisationsname

### Design-Elemente

[](#design-elemente)

- `apple_icon` - Icon (29x29pt)
- `apple_icon2x` - Icon @2x (58x58pt)
- `apple_logo` - Logo
- `apple_strip` - Strip-Bild (optional)
- `apple_background` - Hintergrundbild (optional)

Verwendung
----------

[](#verwendung)

```
use Tualo\Office\PKPass\PKPass;

// Parameter für den Pass
$params = [
    'apple_backgroundColor' => 'rgb(240,240,240)',
    'apple_foregroundColor' => 'rgb(0,0,0)',
    'apple_labelColor' => 'rgb(0,0,0)',
    'apple_logoText' => 'Meine Veranstaltung',
    'description' => 'Event Ticket',
    'KEY_PRIMERY:LABEL' => 'Veranstaltung',
    'KEY_PRIMERY:VALUE' => 'Konzert 2026',
    'KEY_HEADER_LOCATION_DATE:LABEL' => 'Datum',
    'KEY_HEADER_LOCATION_DATE:VALUE' => '19.01.2026 20:00',
    'utc_datetime' => '2026-01-19T20:00:00+01:00'
];

// Pass erstellen
PKPass::pass('UNIQUE-TICKET-ID', $params);
```

Pass-Felder
-----------

[](#pass-felder)

Das Modul unterstützt verschiedene Feldtypen für Event-Tickets:

- **Primary Fields**: Hauptinformationen (Veranstaltungsname)
- **Header Fields**: Datum/Uhrzeit
- **Secondary Fields**: Ticket-Typ
- **Auxiliary Fields**: Sitzplatznummer
- **Back Fields**: Zusätzliche Informationen auf der Rückseite

Anforderungen
-------------

[](#anforderungen)

- PHP >= 7.4
- Tualo Office Framework
- pkpass/pkpass ~2.4.0
- Gültiges Apple Developer Zertifikat
- Apple WWDR Zertifikat

Weiterführende Dokumentation
----------------------------

[](#weiterführende-dokumentation)

Offizielle Apple PassKit Dokumentation: [https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit\_PG/Creating.html](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html)

Lizenz
------

[](#lizenz)

MIT License

Autor
-----

[](#autor)

Thomas Hoffmann -

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance78

Regular maintenance activity

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity40

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.

###  Release Activity

Cadence

Every ~50 days

Total

5

Last Release

117d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/329ac1f2a4f83be89056acc761999cdc6baaf24b63318c371d3e1a950ad45d9f?d=identicon)[tualo](/maintainers/tualo)

---

Top Contributors

[![thomashoffmann1979](https://avatars.githubusercontent.com/u/1321200?v=4)](https://github.com/thomashoffmann1979 "thomashoffmann1979 (17 commits)")

### Embed Badge

![Health badge](/badges/tualo-pkpass/health.svg)

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

PHPackages © 2026

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