README

Content wrappers for the Islamic Network ilm CMS: the shared layer between Directus and the public Kipchak APIs (pray, events, people). Included as a Composer package by the APIs and the Islamic Network SDK.

Everything the API contracts promise that Directus doesn't do lives here:

The response envelope ({code, status, data}) is not here — Kipchak owns it.

Requirements

PHP 8.4+ (uses the new Dom\HTMLDocument API), ext-dom, ext-intl, ext-mbstring.

Tests are the contract

tests/fixtures/ holds copies of the locked API samples from ../api/. The pipeline tests assert that rendering each sample's raw produces its html byte-for-byte (modulo inter-tag whitespace) — if a convention changes, change the sample first and the tests say what code must follow.

composer install
composer test

Usage sketch

use IslamicNetwork\Qalam\Directus\Translations;
use IslamicNetwork\Qalam\Text\Prose;
use IslamicNetwork\Qalam\Content\Times;

$t = new Translations($directusRow['translations']);

$record = [
    'name'         => $t->text('name'),          // {ar, ar-Latn, en}
    'description'  => $t->prose('description'),  // {en: {raw, html}}
    'translations' => $t->text('translation'),   // {ar-Latn, en, ur, …}
    'times'        => Times::toApi($junction['times']),
];