{"id":21330601,"url":"https://github.com/friendsofredaxo/insert_text","last_synced_at":"2026-04-01T20:43:25.918Z","repository":{"id":45076427,"uuid":"147743870","full_name":"FriendsOfREDAXO/insert_text","owner":"FriendsOfREDAXO","description":"Erweitert den Medienpool um einen Effekt zur Ausgabe von Text im Bild","archived":false,"fork":false,"pushed_at":"2025-01-26T15:11:57.000Z","size":12897,"stargazers_count":21,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-12T09:38:56.951Z","etag":null,"topics":["addon","image-manipulation","php","redaxo","redaxo-addon","text-generation","watermarking"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FriendsOfREDAXO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-06T23:14:28.000Z","updated_at":"2025-01-26T15:11:54.000Z","dependencies_parsed_at":"2025-01-26T16:21:21.487Z","dependency_job_id":null,"html_url":"https://github.com/FriendsOfREDAXO/insert_text","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/FriendsOfREDAXO/insert_text","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Finsert_text","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Finsert_text/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Finsert_text/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Finsert_text/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FriendsOfREDAXO","download_url":"https://codeload.github.com/FriendsOfREDAXO/insert_text/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfREDAXO%2Finsert_text/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["addon","image-manipulation","php","redaxo","redaxo-addon","text-generation","watermarking"],"created_at":"2024-11-21T22:22:59.266Z","updated_at":"2026-04-01T20:43:25.902Z","avatar_url":"https://github.com/FriendsOfREDAXO.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Insert Text\n\nDieses Addon erweitert den Media Manager um den Effekt `Bild: Text einfügen`.\nDer Effekt fügt Text in ein Bild ein ;)\n\nDer Effekt kann genutzt werden um z.B. einen Copyright-Hinweis, Erstellungsdatum, Bild-Titel usw. auf Bildern auszugeben.\n\n**Beispiel:** (Ok, bisserl Overdressed)\n\n![Screenshot](https://raw.githubusercontent.com/FriendsOfREDAXO/insert_text/assets/insert_text_demo1.png)\n\n[Photo by Angèle Kamp on Unsplash](https://unsplash.com/@angelekamp) - [Photo](https://unsplash.com/photos/IWzloaVyoOw) (Zitat: Alexander Solschenizyn)\n\nIm Beispiel oben der Effekt mit Font `a song for jennifer`, ein paar extra Leerzeichen im Text, Schriftgröße 90, center, middle, Schriftglättung 1 und Drehung 3 Grad.\n\n\u003e **Hinweis:** Für optimale Ergebnisse und Schonung der Ressourcen bei großen Bildern sollten zuerst die Effekte `Bild: Skalieren`, `Bild: Beschneiden` usw. angewendet werden.\n\n\u003e **Noch ein Hinweis:** Ausgabe im Format PNG/WEBP erzielt bessere Ergebnisse als JPG. Effekt `Bild: In JPEG/PNG/GIF/WEBP konvertieren`.\n\n## Effekt-Parameter\n\nDie folgenden Parameter können für den Effekt eingestellt werden.\n\nDie beim Effekt eingestellten Werte gelten als \"Default\" und können bei Bedarf über die [**Effekt-Parameter in Meta-Daten**](#metaconfig) für jedes Bild individuell geändert werden.\n\n\u003e **Hinweis:** Bei RGBA für die Farben ist nicht CSS-RGBA gemeint, sondern der RGBA-Wert für GD! Siehe https://www.php.net/manual/de/function.imagecolorallocatealpha.php\n\n| Parameter | Beschreibung / Mögliche Werte  |\n|---|---|\n| **Textausgabe** | Text der auf dem Bild ausgegeben wird. |\n| **Textquelle** | Hier kann die Textquelle des Effekts ausgewählt werden. `input` für das Feld `Textausgabe` **oder** ein beliebiges Meta-Feld aus dem Medienpool.\u003cbr\u003eEs kann auch eine Textarea aus dem Medienpool ausgewählt werden die noch weitere Möglichkeiten zu diesem Effekt eröffnet (siehe [hier](#metaconfig)) |\n| **Schriftgröße** | Ausgabe-Größe für den Text (einfach bisserl rumprobieren!)|\n| **Schriftdatei** | Hier kann eine beliebige Font-Datei (.ttf, .otf) aus dem Medienpool ausgewählt werden |\n| **Schriftfarbe** | Farbe für die Text-Ausgabe\u003cbr\u003eDie Schriftfarbe kann in zwei verschiedenen Formaten angegeben werden:\u003cbr\u003e1) Hex-Farbwert ohne Alpha-Transzparenz z.B. `#fff` oder `#ffffff` \u003cbr\u003e2) RGBA-Wert (GD) mit Alpha-Transparenz z.B. `255,255,255,66` |\n| **Horizontale Ausrichtung** | Horizontale Ausrichtung des Textes.\u003cbr\u003eMögliche Werte: `left` `center` `right` |\n| **Vertikale Ausrichtung** | Vertikale Ausrichtung des Textes.\u003cbr\u003eMögliche Werte: `top` `middle` `bottom` |\n| **Horizontaler Abstand zum Rand** | Horizontaler Abstand des Textes zum Rand (es sind auch negative Werte möglich) |\n| **Vertikaler Abstand zum Rand** | Vertikaler Abstand des Textes zum Rand (es sind auch negative Werte möglich) |\n| **Schriftglättung** | Schriftglättung für die Textausgabe\u003cbr\u003eMögliche Werte: `0` bis `5`\u003cbr\u003e`0` = ohne Schriftglättung (z.B. für Pixelfonts)\u003cbr\u003e`1` = Standard (normalerweise ausreichend)\u003cbr\u003e**Achtung:** ein Wert größer 1 benötigt natürlich mehr Ressourcen! |\n| **Farbe Text-Schatten** | Der Text kann auch mit einem Schatten versehen werden\u003cbr\u003eDie Farbe für den Schatten kann in zwei verschiedenen Formaten angegeben werden:\u003cbr\u003e1) Hex-Farbwert ohne Alpha-Transzparenz z.B. `#fff` oder `#ffffff` \u003cbr\u003e2) RGBA-Wert (GD) mit Alpha-Transparenz z.B. `255,255,255,66` |\n| **Farbe Text-Hintergrund** | Text mit einer Hintergrundfarbe unterlegen\u003cbr\u003eDie Hintergrundfarbe kann in zwei verschiedenen Formaten angegeben werden:\u003cbr\u003e1) Hex-Farbwert ohne Alpha-Transzparenz z.B. `#fff` oder `#ffffff` \u003cbr\u003e2) RGBA-Wert (GD) mit Alpha-Transparenz z.B. `255,255,255,66` |\n| **Padding Text-Hintergrund** | Hier kann der Seitenabstand der Schrift zum farbigen Hintergrund festgelegt werden\u003cbr\u003eMögliche Werte: z.B. `10` (auch hier bei Bedarf bisserl probieren)|\n| **Textdrehung** | Der Text kann auch \"gedreht\" ausgegeben werden.\u003cbr\u003eMögliche Werte: `0` bis `360` (nachdenken!)\u003cbr\u003epositiver Wert: Drehung nach Links\u003cbr\u003enegativer Wert: Drehung nach Rechts |\n\n## Screenshot Effekt-Parameter\n\nHier die Parameter die bei einfügen des Effekts vorgeblendet werden.\nOhne Änderung der Parameter wird der Text oben mittig mit einem Abstand von 30 Pixeln in schwarz ausgegeben.\n\n![Screenshot](https://raw.githubusercontent.com/FriendsOfREDAXO/insert_text/assets/insert_text-effekt-configuration.png)\n\n\u003ca name=\"metaconfig\"\u003e\u003c/a\u003e\n\n## Effekt-Parameter in Meta-Daten\n\nDie in dem Effekt eingestellten Werte gelten als \"Default\" für alle Bilder auf die dieser Medientyp angewendet wird.\n\nWenn eine \"Textarea\" aus den Meta-Daten als Textquelle ausgewählt wurde, kann für jedes Bild eine individuelle Einstellung zum Effekt angewendet werden.\n\nDafür muss in der **1.** Zeile der Textarea eine Zeile mit den Parametern eingefügt werden.\nTrennzeichen der Parameter ist `|`, bekannt aus `yform`.\n\n### Format der Parameter im Meta-Feld\n\nDie Erste Zeile in der Textarea in folgendem Format\n\n```\n0        1        2     3    4    5          6         7         8           9       10        11\nfonzsize|font.ttf|color|hpos|vpos|offsetleft|offsettop|antialias|shadowcolor|bgcolor|bgpadding|angle\n```\n\nWerte die in dieser Zeile nicht gesetzt werden, werden aus dem definierten Effekt im Medientyp übernommen.\n\nWerte die hier gesetzt werden überschreiben den Wert aus dem definierten Effekt im Medientyp.\n\n**Beispiel:**\n\nEin Meta Textarea-Feld mit individuellen Einstellungen zu diesem einen Bild im Medienpool.\n\n```\n90|a_song_for_jennifer.ttf|#3e3e3e|center|middle|0|0|1||||3\nDie Lösung\nist immer\neinfach.\n\nMan muss\n  sie nur\n    finden.\n```\n\n## Noch Fragen oder Anregungen? Einen Bug gefunden?\n\nDann geht es hier weiter ...\n\n* Auf Github: [https://github.com/FriendsOfREDAXO/insert_text](https://github.com/FriendsOfREDAXO/insert_text)\n\n* im Slack-Channel: [https://friendsofredaxo.slack.com/](https://friendsofredaxo.slack.com/)\n\nHier noch ein Beispiel mit der **mehrfachen** Anwendung des Effekts: (Spielerei wenn man Zeit hat oder nicht schlafen kann)\n\n![Screenshot](https://raw.githubusercontent.com/FriendsOfREDAXO/insert_text/assets/insert_text_demo2.png)\n\n## Credits\n\n* [Friends Of REDAXO](https://github.com/FriendsOfREDAXO)\n\n* [Michael Ziem](https://github.com/mizmiz) (Project Lead)\n\n* [Andreas Eberhard](https://github.com/aeberhard)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendsofredaxo%2Finsert_text","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffriendsofredaxo%2Finsert_text","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriendsofredaxo%2Finsert_text/lists"}