Antragsgrün 4.2.3: Zugangsschutz praktisch gedacht

Nutzung eines gemeinsamen Zugangspassworts nun pro Veranstaltung möglich

Das neue Antragsgrün 4.2.3 verbessert den einfachen Zugangsschutz, der in Version 4.2.2 eingeführt wurde: Als Alternative zu individuellen Nutzerkonnten war es bisher nur möglich ein gemeinsames Passwort als Zugangsschutz für die gesamte Instanz festzulegen. Das bedeutete, dass alle Veranstaltungen automatisch mit diesem Passwort vor Zugriffen von außen geschützt waren. Tatsächlich ist es aber so, dass oftmals einzelne Veranstaltungen geschützt, andere aber öffentlich einsehbar sein sollen. Diesem Wunsch vieler einsetzender Organisationen wurde nun Rechnung getragen. Das gemeinsame Passwort ist nun pro einzelner Veranstaltung definierbar.
Davon unberührt sind natürlich Admin-Accounts, die man immer noch zum Verwalten braucht, und die sich unabhängig vom gemeinsamen Passwort einloggen.

Kleinere Fehlerbehebungen und Sicherheitsaktualisierungen

Es wurde ein Fehler behoben, der beim Zusammenspiel von automatischen Benachrichtigungen zu einer Veranstaltungen und nicht mehr existierenden (gelöschten) Accounts auftrat. Außerdem wurden einige Systembibliotheken aktualisiert.

Wie bekommt man die neue Version?

Wir empfehlen euch die neue Version über den Online-Updater im Backend von Antragsgrün einzuspielen. Der Aktualisierungsvorgang erfordert nur wenige Mausklicks und ist in weniger als einer Minute abgeschlossen.
Wenn ihr Antragsgrün erstmalig installieren möchtet, erhaltet ihr die Installationsdateien direkt im öffentlichen Github-Repository: https://github.com/CatoTH/antragsgruen/releases. Die Installations-Datei (z.B. als ZIP) muss entpackt und in ein Verzeichnis bei eurem Webhoster transferiert werden. Beim ersten Aufruf des Verzeichnisses über euren Browser startet der Einrichtungsassistent, der die Datenbank und die erste Veranstaltung anlegt.

Antragsgrün – die wichtigsten Tipps und Tricks

Seit mehreren Jahren entwickelt der DBJR mit an der Software »Antragsgrün«. Damit können Texte gemeinsam und demokratisch erstellt werden. Wir haben in diesem Artikel für euch die wichtigsten Punkte zusammengetragen, die einen erfolgreichen Start mit Antragsgrün erleichtern.

Antragsgrün auf Tablet
Antragsgrün auf einem Tablet (Foto: Michael Scholl)

EINRICHTUNG

Antragsgrün kann entweder selbst installiert werden, z.B. parallel zur eigenen Website, oder bei antragsgruen.de mitgenutzt werden. Wenn man die Software selbst betreibt, ist die Nutzung kostenlos und kann frei selbst verändert und angepasst werden. Eine englische und französische Sprachversion steht zur Verfügung.

Antragsgrün denkt in „Veranstaltungen“ (englisch leider etwas missverständlich als „consultations“). Eine Veranstaltung ist dabei beim Aufruf der Hauptadresse zu sehen, die weiteren sind durch ein angehängtes Kürzel wie /web/vollversammlung2019 erreichbar. Die auf der Startseite sichtbare Veranstaltung kann jederzeit geändert werden.

Pro Veranstaltung können Nutzerrechte unterschiedlich festgelegt werden. Die Sprache der Installation ist allerdings nur einmal für das Gesamtsystem festlegbar.

Von Seiten des Orga-Teams können mehrere Personen gleichzeitig mit demselben Admin-Account eingeloggt sein. Zu beachten ist, dass man nicht parallel dieselben Anträge/Dokumente verändert, da Antragsgrün dies nicht beherrscht.

Das Logo links oben kann pro Veranstaltung neu festgelegt werden.

Der einführende Text für eine Veranstaltung kann mit Grafiken und anderen Elementen erweitert werden. Allerdings sollte die Einführung nicht zu lang ausfallen, da die Teilnehmenden sonst zu viel scrollen müssen.

Alle Labels, Buttontexte, System-Mails usw. können zentral über „Sprache anpassen“ verändert und an die Begriffe in der eigenen Organisation angepasst werden. Der Ursprungszustand pro Element ist jederzeit wieder herstellbar.

In der Grundeinstellung werden pro Veranstaltung mehrere Anträge aufgelistet. Eine Tagesordnung kann angelegt werden, ist aber optional. Und eine Minimalfassung ist ebenfalls möglich: Beim Aufruf von Antragsgrün erscheint dann genau ein Antrag.

Tipp: Onlineübersetzung einbinden, z.B. Google-Translate. Das geht am einfachsten, wenn man den Dienst direkt aufruft, die gewünschte Sprachkombination und als Übersetzungsquelle die Adresse der eigenen Antragsgrün-Installation eingibt. Der so entstandene Link kann dann wiederum kopiert und in den Infobereich in Antragsgrün als Link eingebaut werden.

Beispiel DBJR (www.dbjr.de/antrag -> ein Schrägstrich in der eigenen Adresse wird übertragen in %2). Die Übersetzung erfolgt aus dem Deutschen (de) ins Englische (en):
https://translate.google.de/translate?sl=de&tl=en&js=y&prev=_t&hl=de&ie=UTF-8&u=https%3A%2F%2Fwww.dbjr.de%2Fantrag&edit-text=

ANTRAGSVERWALTUNG

Im Standard bestehen Anträge aus einem Titel, einem Antragstext und einer Begründung. Die Elemente können erweitert/gekürzt werden („Antragstypen“), wenn man z.B. den Text noch in einer weiteren Fassung (kindgerecht o.ä.) beraten werden soll.

Der Wortlaut des Originalantrags kann von Seiten des Orga-Teams redaktionell bearbeitet werden (z.B. um Tippfehler zu korrigieren), allerdings darf dies nicht mehr geschehen, sobald ein erster Änderungsantrag eingegangen ist. Es könnte sonst sein, dass Antragsgrün die Änderungen nicht mehr zuordnen kann. Status und Eigenschaften von Anträgen und Änderungsanträgen können jederzeit geändert werden.

Das Orga-Team entscheidet, ob Anträge und Änderungsanträge freigeschaltet werden oder ohne manuelle Kontrolle sichtbar sein können. Ebenfalls können sie entscheiden, ob nur eingeloggte Nutzer*innen Anträge stellen können. Seit Juni 2019 ist es zudem die Möglichkeit geben für eine Veranstaltung ein gemeinsames Zugriffspasswort zu vergeben, so dass der generelle Zugriff zwar nicht frei ist, die Nutzer*innen aber danach frei bzgl. der Angaben sind.

LIVE DISKUTIEREN

Der Modus „Änderungsanträge einpflegen“ ermöglicht eine Live-Diskussion z.B. über eine Visualisierung auf eine gemeinsame Leinwand. Zudem können die Zwischenstände auch von anderen Endgeräten abgerufen werden, wenn dies während der Live-Beratung so aktiviert wird. Die Zwischenstände werden einmal minütlich aktualisiert. Sie bieten den Teilnehmenden den großen Vorteil, dass sie im Text nach oben und unten wandern können, während auf einer Leinwand nur ein bestimmter Teil angezeigt wird.

Tipp:

  • Fürs Beamen wird empfohlen die Vollbildansicht im Browser zu aktivieren (in der Regel über Taste F11 an/aus). Zudem kann mit STRG + und STRG – oder über STRG und Mausrad die Zoomansicht im Browser verändert werden. Damit kann die zur Verfügung stehende Leinwand bestmöglich ausgenutzt werden.

Zeilennummern: Durch papiergebundene Diskussion sind Teilnehmende sehr stark an Zeilennummern gewöhnt. Da Antragsgrün jedoch jegliche Änderungen, also sowohl Einfügungen wie auch Löschungen, live anzeigt, sind Zeilennummern eher hinderlich und werden daher auch nicht angezeigt. Es ist sinnvoll bei mündlicher Beratung den aktuellen Absatz oder Satz einfach konkret zu nennen („Im Absatz, der mit den Worten xyz beginnt…“).

Bei konkurrierenden Änderungsanträgen soll meistens die am weitest reichende Änderungen zuerst besprochen werden. Antragsgrün zeigt zwar an, dass Änderungsvorschläge konkurrieren, kann aber natürlich nicht inhaltlich die Qualität der Änderungen erkennen. Hier muss die Moderation inhaltlich eingreifen und die Diskussionsreihenfolge selbst festlegen.

Grundsätzlich gibt es zwei Modi in Antragsgrün: Ein Änderungsantrag kann sich auf nur eine oder auf beliebig viele Änderungsanträge im Text beziehen. Änderungsanträge über mehrere Stellen werden jedoch von Antragsgrün nicht in Abhängigkeit zueinander gesetzt, sondern einfach nacheinander aufgerufen. Hier ist der/die Antragstellende in der Aufgabe ggf. Abhängigkeiten mündlich zu erläutern. Aus Erfahrung empfehlen wir eher nicht, dass Antragsgrün so eingestellt wird, dass für jede Textänderung ein neuer Änderungsantrag gestellt werden muss – der organisatorische Aufwand zum Stellen und Freigeben ist dann einfach recht groß.

Tipps:

  • Über STRG F kann in den meisten Browsern nach Wörtern gesucht werden.
  • Wenn man mal einen Fehler gemacht hat, auch kein Problem: STRG Z macht die letzte Text-Aktion wieder rückgängig.
  • Sollten mehrere mündliche Vorschläge ausgesprochen werden, können sie als Alternativen temporär in den Text für die Leinwand geschrieben werden, z.B. mit eckigen Klammern markiert.

Änderungsanträge von Teilnehmenden können während der Live-Beratung nicht mehr schriftlich automatisch angenommen werden: Es gilt der Stand zu dem der Modus „Änderungsanträge einpflegen“ aktiviert wurde.

Ab Sommer 2019 kann auch das Abstimmungsergebnis zu einem Antrag erfasst werden.

AKTUELL HALTEN

Antragsgrün kann über einen Web-Updater direkt aus der Administrationsoberfläche auf neue Versionen aktualisiert werden. Der Vorgang dauert in der Regel nur wenige Momente – jeweils mit einem eigenen Vorgang für den Programmcode und für die Datenbank-Struktur.

Wenn während der Nutzung von Antragsgrün unklare Probleme auftreten, dann kann eine Log-Datei eingesehen werden unter /runtime/logs/app.log. Die Einträge sind dabei sehr ausführlich gehalten.

Generell ist zu empfehlen, den Server immer einigermaßen aktuell zu halten. Dasselbe gilt für Browser, die mit Antragsgrün arbeiten sollen. Von der Nutzung des Microsoft Internet Explorer muss abgeraten werden, da er seit vier Jahren nicht mehr weiter entwickelt wird (Microsoft hat mit dem Browser Microsoft Edge einen Nachfolger im Angebot). Wir testen vor allem unter Mozilla Firefox, Chromium & Google Chrome, Apple Safari.

HILFE UND INFOS BEKOMMEN

Habt ihr noch weitere Tipps für Antragsgrün? Lasst es uns wissen!

Antragsgrün 4.2.2 mit nützlichen Neuerungen

Antragsgrün 4
Antragsgrün 4 (Montage: DBJR)

Wenngleich die kleine Veränderung bei der Versionsnummer nur wenig Neues vermuten lässt, so bringt die neueste Antragsgrün-Version ein paar nützliche Verbesserungen mit. Wir stellen sie euch im Folgenden vor.

Gemeinsames Passwort als Zugangsschutz für eine Veranstaltung
Oft nachgefragt wurde die Option für eine Veranstaltung ein gemeinsames Zugriffspasswort zu vergeben: Damit kann die Antragsgrün-Installation zwar öffentlich erreichbar bleiben, aber dennoch die aktuelle Diskussionsrunde vor der Öffentlichkeit geschützt werden. Einzelne Nutzeraccounts waren für diesen Fall oft zu aufwändig. Mit der aktuellen Version 4.2.2 ist dieses Einfachpasswort nun möglich. Wir müssen jedoch noch darauf hinweisen, dass das Setzen des Passwortes im Augenblick immer auch die gerade aktive Standardveranstaltung auf der Titelseite geschützt schaltet. Erst in der nächsten Version, die noch in den Sommermonaten erscheinen wird, wird es die Funktion geben einzelne Veranstaltungen jeweils individuell zu schalten.

Aktivitäten-Liste
Zu jeder Veranstaltung gibt es rechts im Seitenbereich einen Aktivitäten-Log. Dieser wurde verbessert: Öffentliche Kommentare werden nun nicht nur genannt, sondern auch inhaltlich angeteasert. Zudem wird die Log-Anzeige nun nicht endlos lang, sondern hat eine Paginierung (Seiten-Unterteilung) bekommen.

Veranstaltungen mit nur einem Antrag
Wenn eine Veranstaltung so konfiguriert ist, dass sie nur einen Antrag hat und dieser wurde durch eine Überarbeitung ersetzt, so wird nun die neue Version als neuer Standardantrag für diese Veranstaltung festgelegt. Auf die vorherige Version wird dabei im Kopfbereich des neuen Antrags verwiesen.

Verfahrensvorschläge: Änderungsanträge modifiziert übernehmen
Wenn zu den Anträgen die Funktion „Verfahrensvorschläge“ aktiviert sind, gibt es nun eine Ablaufverbesserung: Man kann man als Admin zu einem Änderungsantrag eine modifizierte Übernahme erstellen, also eine geänderte Fassung des Änderungsantrags. Dann kann man jetzt sowohl beim Einpflegen aller Änderungen auf einmal jeweils zwischen der Original- und der Fassung inkl. modifizierter Übernahme wählen (das ging vorher schon), als auch wenn man nur eine Änderung in den Antrag einpflegt (das ging vorher noch nicht).

Antragstypen / Vorlagen
Antragsgrün erlaubt es zu jeder Veranstaltung den Aufbau von Antragstypen neu zu definieren. Der Grundaufbau Titel – Antragstext – Begründung kann ergänzt oder verändert werden. Antragsgrün ist dabei nun etwas fehlertoleranter geworden: Wenn mehrere Abschnitte als Typ „Titel” definiert wurden, werden die zweiten, dritten usw. nun als reguläre Abschnitte behandelt und somit angezeigt.

Wie bekommt man die neue Version?
Wir empfehlen euch die neue Version über den Online-Updater im Backend von Antragsgrün einzuspielen. Der Aktualisierungsvorgang erfordert nur wenige Mausklicks und ist in weniger als einer Minute abgeschlossen.
Wenn ihr Antragsgrün erstmalig installieren möchtet, erhaltet ihr die Installationsdateien direkt im öffentlichen Github-Repository: https://github.com/CatoTH/antragsgruen/releases. Die Installations-Datei (z.B. als ZIP) muss entpackt und in ein Verzeichnis bei eurem Webhoster transferiert werden. Beim ersten Aufruf des Verzeichnisses über euren Browser startet der Einrichtungsassistent, der die Datenbank und die erste Veranstaltung anlegt.

Antragsgrün 4.2.1 – kleines Update

Am Wochenende wurde ein kleines Update von Antragsgrün veröffentlicht. Es beinhaltet vor allem Fehlerbehebungen sowie kleine Verbesserungen für den Multi-Site-Betrieb. Wir empfehlen euch das Update über den Online-Updater im Backend von Antragsgrün einzuspielen. Der Aktualisierungsvorgang erfordert nur wenige Mausklicks und ist in weniger als einer Minute abgeschlossen.

Welche Probleme wurden behoben

  • Logos, deren Dateinamen bestimmte Sonderzeichen beinhalteten, wurden beim PDF-Export nicht angezeigt.
  • Schlagwörter mit dem &-Zeichen wurden zuvor falsch kodiert. Wichtig zu wissen: Die Fehlerbehebung verändert die alten Schlagwörter nicht rückwirkend, sondern kann nur die korrekte Erstellung neuer Tags sicherstellen.
  • Wenn Nutzer*innen Kommentare entfernt hatten, trug Antragsgrün bisher verwirrende Einträge ins Aktivitäten-Log ein.
  • Wenn Nutzer*innen ohne Login PDF-Dokumente zu Bewerbungsverfahren hochgeladen hatten, zeigte Antragsgrün bisher das PDF auf der Bestätigungsseite nicht korrekt an.
  • Das Aussehen von Links in der Seitenleiste ist nun einheitlicher.
  • Beim Anlegen der Liste von administrativen E-Mail-Adressen für Benachrichtigungen kann als Trennzeichen nun sowohl Komma wie auch Semikolon verwendet werden.

Verbesserungen im Multi-Site-Betrieb

Wenn Antragsgrün im Multi-Site-Modus betrieben wird, also eine gemeinsame Antragsgrün-Installation über mehrere Domains angesprochen werden kann, sind Plugins nun einzeln pro Subdomain aktivierbar. Ebenso setzt Antragsgrün nun die E-Mail-Adresse des Admins automatisch als Reply-To für Systemmails, falls für die Subdomain nichts Anderes eingerichtet wurde.

Noch kein Antragsgrün in Benutzung?

Wer Antragsgrün erstmalig installieren möchte, erhält die Installationsdateien wie immer direkt im öffentlichen Github-Repository: https://github.com/CatoTH/antragsgruen/releases. Die Installations-Datei (z.B. als ZIP) muss entpackt und in ein Verzeichnis bei eurem Webhoster transferiert werden. Beim ersten Aufruf des Verzeichnisses über euren Browser startet der Einrichtungsassistent, der die Datenbank und die erste Veranstaltung anlegt.

Antragsgrün 4.2 im Anflug: Designwahl, private Notizen

In wenigen Tagen erscheint Antragsgrün 4.2. Bereits jetzt kann der erste, stabile Release-Kandidat (RC) ausprobiert werden. Darin enthalten sind Funktionen, die schon häufig und auch seit Langem nachgefragt wurden:

Screenshot Farbschema-Einstellungen
Farben und Schriften können nun selbst angepasst werden. (Klicken, um Bild zu vergrößern)

Das Design von Antragsgrün kann nun direkt über das Backend angepasst werden. Eurer Kreativität (oder euren CI-Designregeln) zu Farben und Schriftarten sind damit keine Grenzen mehr gesetzt. Und falls doch mal was schiefläuft: Alle Werte lassen sich wieder auf die Standardeinstellungen zurücksetzen. Seit einigen Monaten bestand darüber hinaus die Möglichkeit, das Seitenlogo pro Veranstaltung neu hochzuladen: Der neue Logo-Picker macht die Anpassungen nun komfortabler als bisher.

Als zweite große Neuerung wird die Möglichkeit eingeführt, dass Nutzer*innen private, also nicht nach außen sichtbare, Notizen zu Anträgen hinterlegen können. Diese Kommentarfunktion orientiert sich dabei an den Textabsätzen und ist vor allem zur Vorbereitung von Live-Diskussionen auf Tagungen nützlich.

Neben diesen beiden großen Neuerungen werden natürlich auch einige Fehler behoben, z.B. der Erstellung aller PDFs in ein ZIP-Paket. Wer sich jetzt bereits an die Vorabversion wagt, kann später natürlich jederzeit zur endgültigen Version von Antragsgrün 4.2 aktualisieren. Weitere Informationen findet ihr unter https://github.com/CatoTH/antragsgruen/releases.

Auf Fehlersuche? Tipps zu ePartool, Antragsgrün, Nextcloud, WordPress & Co.

Wenn dieser Fehler auftaucht, ist guter Rat teuer … oder?

Mittlerweile stehen viele hochwertige Open-Source-Anwendungen für eure Onlineauftritte oder Onlinezusammenarbeit zur Verfügung. Auch wenn sich Entwickler*innen große Mühe geben eine tolle Software zu schreiben, so schleichen sich doch immer wieder Fehler ein. Ebenso können sich im Zusammenspiel zwischen Anwendung und eigenem Server Probleme auftun, die einer Lösung bedürfen. Vor der Lösung steht jedoch die Fehlersuche: Oft lässt sich nicht per Augenschein erkennen, woran es hakt. Im Folgenden geben wir ein paar Tipps, wie ihr euch dem Problem nähert.

Die Log-Datei ist dein Freund!

Glücklicherweise werdet ihr bei der Fehlersuche von der Software aktiv unterstützt. Die meisten Anwendungen und auch die Server selbst legen verschiedene Protokoll-Dateien an. In diesen wird aufgezeichnet, welche Aktionen stattgefunden haben bzw. bei welchen Aktionen unvorhergesehene Ereignisse auftraten. Aus unserer Erfahrung lohnt es sich bei Problemen im ersten Schritt die Log-Dateien der betroffenen Anwendung anzusehen. Die meisten Fehler lassen sich hierüber bereits eingrenzen.

Log-Dateien werden fast immer als Dateien mit der Endung .log angelegt. Es handelt sich dabei aber in der Regel um Textdateien, die sich mit jedem beliebigen Editor öffnen lassen (Notepad, Wordpad, usw.).

In den Logs der Anwendungen wird in der Regel protokolliert, wenn einzelne Funktionen oder Programmbibliotheken eine Aufgabe nicht ausführen konnten. Das könnte z.B. daran liegen, dass Zugriffsrechte nicht korrekt gesetzt waren, benötigte Dateien nicht gefunden wurden, ein Datenbankserver nicht oder nicht schnell genug geantwortet hat, oder Funktionen schlichtweg Fehler hatten (Beispiel: Versuch durch 0 zu teilen). Dennoch können sich die Inhalte der Log-Dateien bisweilen sehr unterscheiden – die Entwickler*innen können sich dafür entscheiden, nicht nur fatale Fehler zu vermerken, sondern auch bereits Warnmeldungen oder auch erfolgreich durchgeführte Aktivitäten. Letzteres kann zwar von Interesse für die Entwickler*innen sein, allerdings im Dauerbetrieb auch mit Datenschutzerfordernissen kollidieren. Daher lassen sich Anwendungen häufig darauf konfigurieren, ob sie sich im Betriebsmodus für „Entwicklung“ (development, debug modus) oder für „Produktion“ befinden.

Anhand von vier Anwendungen möchten wir euch beispielhaft aufzeigen, wo Log-Dateien zu finden sind:

Antragsgrün: Die Software zur demokratischen Texterstellung führt eine Log-Datei unter /runtime/logs/app.log. Die Einträge sind dabei sehr ausführlich gehalten.

ePartool: Das DBJR-Konsultationswerkzeug führt eine Log-Datei unter /runtime/logs/application.log. Die neuesten Einträge finden sich ganz unten.

Nextcloud: Die populäre Open-Source-Plattform für Dateiaustausch und Zusammenarbeit führt zwei unterschiedliche Log-Dateien. Während die Datei /data/updater.log nur über Installationsvorgänge Buch führt, ist die Datei /data/nextcloud.log für den täglichen Betrieb gedacht. Nextcloud beinhaltet zudem eine Zugriffsmöglichkeit auf diese Log-Datei über das Admin-Backend. Hier kann man auch einstellen, welche Art von Fehlern oder Problemhinweisen protokolliert werden sollen.

WordPress: In der Standardinstallation führt das CMS keine Log-Datei. Durch zwei Einträge in der Datei wp-config.php kann das Loggen aber aktiviert werden:

define('WP_DEBUG', true);

define('WP_DEBUG_LOG', true);

Weitere Informationen finden sich unter https://codex.wordpress.org/Debugging_in_WordPress.

Wenn man Log-Dateien über das administrative Backend betrachten und auswerten möchte, muss zudem ein Plugin installiert werden, z.B. der »Error Log Monitor« [https://de.wordpress.org/plugins/error-log-monitor/]

Weitere Log-Dateien

Gelegentlich helfen die Log-Dateien der Anwendungen aber nicht weiter. Das kann daran liegen, dass die Anwendung auf Probleme stößt, die außerhalb ihrer eigenen Analysemöglichkeit liegen. Im Extremfall wäre das bei einem Hardware-Defekt der Fall: Ob alle Kabel richtig stecken oder ob der Servercomputer selbst richtig rechnet, kann eine Anwendung kaum erkennen. Auf Log-Dateien der Betriebssystem-Ebene hat man jedoch in der Regel als Mieter*in eines Webhostings keinen Zugriff. Professionelle Provider stellen durch Überwachungsprogramme sicher, dass diese Art von Fehlern von ihnen selbst zeitnah entdeckt werden.

Zwischen dem Betriebssystem und Anwendungen wie den vier oben genannten liegt allerdings noch die installierte Web-Server-Software. Ein Web-Server ist meist als Sammelbegriff mehrerer Programme zu verstehen und beinhaltet neben dem eigentlichen Web-Server-Programmen wie Apache oder Nginx auch die PHP-Programmiersprache oder eine Datenbank). Diese alle führen ebenfalls Log-Dateien.

Welche Log-Datei hilft wann:

Web-Server: Hier werden der Zeitpunkt und die Herkunft der Zugriffe (IP-Adressen), Größe der abgerufenen Dateien und Statusmeldungen zu den einzelnen Verbindung geloggt. So lässt sich schnell herausfinden, ob es zeitgleich übermäßig viele Zugriffe gab (und daher der Server sehr langsam wurde) oder ob bestimmte Dateien nicht gefunden wurden (die bekannte Statusmeldung 404). Probleme im internen Programmablauf, die nicht die Zugriffe betreffen, werden meistens in einer separaten Log-Datei protokolliert.

PHP: Programmierfehler sind häufig kleine Tippfehler, wie eine vergessene Klammer zum Abschluss einer Funktion oder ein Buchstabendreher. Wenn der PHP-Interpreter nicht versteht, was er zu tun hat, können diese Fehler entweder geloggt oder direkt angezeigt werden. Letzteres hilft zwar, Fehler schnell zu finden, verrät aber Externen auch viel über mögliche Angriffspunkte. Bei PHP-Skripten kann man auch ohne viel Programmiererfahrung das Anzeigen von Fehlern aktivieren, indem man in die ersten Zeilen (nach dem Startkennzeichen <?php) folgende Befehle ergänzt:

error_reporting(E_ALL);
ini_set('display_errors', '1');

Voraussetzung dafür, dass nun konkrete Fehlermeldungen angezeigt werden, ist, dass der Server grundsätzlich dazu konfiguriert ist. Bei den meisten Providern lässt sich das im Administrationsmenü aktivieren und wieder deaktivieren. Bei direktem Server-Zugang und Schreibrechten auf die php.ini-Einstellungsdatei lässt sich dies durch display_errors = on aktivieren.

Datenbank: Da es verschiedene weit verbreitete Datenbanken gibt, fällt die Erkenntnismöglichkeit hier sehr unterschiedlich aus. General lässt sich über die Log-Datei herausfinden, ob der Service korrekt gestartet wurde, ob es gescheiterte Zugriffsversuche gab (z.B. wenn die Zugangspasswörter in der zugreifenden Anwendung falsch abgespeichert waren). Möglicherweise kann man über die Statusmitteilungen auch herausfinden, ob Datenbank-Anfragen ineffizient gestellt wurden und daher sehr lange zur Beantwortung brauchten oder gar komplett scheiterten. Dies könnte z.B. der Fall sein, wenn Suchindizes nach größeren Datenveränderungen nicht neu angelegt wurden oder durch zu viele parallel Schreibvorgänge versucht wurden. Auch der Ursprung von fehlerhafte Zeichenausgabe (Umlaute oder falsche Symbole) könnte hier liegen: Die Kette der Zeichenkodierung muss von der Datenbankablage über die Verbindung und Verarbeitung bei der Anwendung bis hin zum Browser bei den Nutzer*innen durchgehend richtig sein.

Der Einfluss von Fehler-Logs auf die Rechenzeit

Das Erstellen von Log-Dateien benötigt immer etwas Rechenzeit. Diese fällt umso größer aus, wenn man sich auf einem höheren Software-Level befindet (System → Server-Software → Anwendung). Daher lohnt es sich bei viel frequentierten Internet-Angeboten, im stabilen Betrieb das Logging durch die Anwendungen soweit wie möglich zu reduzieren.

Antragsgrün-Tipp: Werbebox ausblenden

Die Antragsgrün-Werbebox auf der Startseite…

Eine Open-Source-Software wie Antragsgrün lässt jederzeit Veränderungen an der Programmierung zu. Gelegentlich sind aber Funktionen auch bereits eingebaut, selbst wenn sie für die Außenwelt nicht gut dokumentiert sind. Eine solche Option möchten wir euch heute vorstellen.

Nach der Einrichtung von Antragsgrün findet sich auf der Startseite der neuen Installation eine kleine „Werbebox“, die neuen Interessierten den Weg zum eigenen Antragsgrün erleichtern soll. Der Hinweistext ist allerdings noch für die ursprüngliche Zielgruppe von Partei-Aktiven formuliert und ist daher für andere Zielgruppen, gerade in der Jugendarbeit, eher verwirrend.

…lässt sich durch einen Datenbank-Kniff schnell deaktivieren.

Die Box lässt sich leider nicht über die Einstellungen im Backend unsichtbar schalten. Über einen kleinen Eintrag in der dazugehörigen (MySQL-)Datenbank funktioniert das dennoch. Und das geht so: Ruft die Datenbankadministration bei eurem Server/Provider auf. Oftmals ist das z.B. das Werkzeug PHPMyAdmin. Ihr müsst in der Antragsgrün-Datenbank die Tabelle »site« suchen und dort im Feld „settings“ den Wert von „showAntragsgruenAd“ von „true“ auf „false“ setzen. Im Screenshot anbei seht ihr, wie das Datenbankfeld korrekt formuliert ist.

Antragsgrün 4.1.1: Accounts löschen und weiteres Finetuning

Update | https://pixabay.com/de/service/license/

In der gestern veröffentlichten Version 4.1.1 von Antragsgrün findet ihr einige Fehlerbehebungen und kleine Verbesserungen:

  • In der Liste der Veranstaltungen erscheint nun die neueste Veranstaltung ganz oben.
  • Ein Klick auf »Änderungen« in der öffentlichen Version eines zusammengeführten Entwurfs öffnet nun immer einen Tooltip mit der Zusammenfassung des Änderungsantrags, einschließlich der Antragstellenden dieses Änderungsantrags.
  • In der tabellarischen Antragsübersicht im Backend werden nun die benutzerdefinierten Statusangaben (Freitextfeld) ebenfalls angezeigt.
  • Bisher war es nicht immer möglich, einmal angelegte Nutzer*innen wieder aus Antragsgrün zu entfernen. Hierfür gibt es nun zwei Wege: Bei der Verwaltung der Liste der zugelassenen Nutzer*innen für eine Veranstaltung, ist es nun möglich diese wieder einzeln zu entfernen. Zudem können Systemadministrator*innen Nutzerkonten nun aus der systemweiten Zugangsliste entfernen.
  • Bugfix: Das Datum des letzten gespeicherten Entwurfs beim Zusammenführen von Anträgen wurde im Safari-Browser nicht korrekt gesetzt.

Wie immer empfehlen wir euch die Neuerungen bequem über den Web-Updater einzuspielen. Das klappt auch diesmal mit wenigen Mausklicks.


Antragsgrün 4.1: Resolutionen, bessere PDFs, Bewerbungen und Verfahrensvorschläge

Vor wenigen Tagen ist Antragsgrün 4.1 erschienen. Die Neuerungen sind diesmal sehr zahlreich, allerdings handelt es sich vor allem um viele kleinteilige Verbesserungen im System.

Neues rund ums Anträge stellen und der Antragsstatus »RESOLUTION«

Im Formular zur Antragseinreichung ist das Beschlussdatum für Organisationen, die einen Antrag stellen, nun optional. Ein zusätzliches optionales Feld, um das Geschlecht von Einzelantragstellenden hinzuzufügen, wurde ergänzt.

Die Differenzialansicht für Änderungsanträge zeigt nun in der Regel die gesamte betroffene Zeile an, anstatt die Zeile nach dem letzten geänderten Wort abzuschneiden. Das erleichtert die Verständlichkeit des Änderungsantrags ein wenig.

Neu eingeführt wurde der Antragsstatus »RESOLUTION« sowie »Resolution(vorläufig)«. So gekennzeichnete Anträge werden auf der Übersichtsseite einer Veranstaltung in einer etwas anderen Ansicht dargestellt (ohne Initator*innen) und haben in der Web- und PDF-Darstellung einen anderen Header als normale Anträge. Eine Resolution beinhaltet weder Änderungen noch Kommentare.

Verbesserte PDFs und Bewerbungen über Antragsgrün

Ein Anwendungsfall von Antragsgrün, über den wir bisher nicht ausführlich berichtet haben, ist die Übermittlung von Bewerbungen, z.B. für Wahlmandate in Organisationen. Zur besseren Unterscheidung zu anderen Anträgen, ist für Bewerbungen eine neue PDF-Vorlage in Antragsgrün hinterlegt. Diese Auswahlfunktion steht jedoch nur zur Verfügung,wenn Antragsgrün nicht auf einem Webhosting, sondern auf einem eigenständigen Server installiert ist (LaTeX-basierte PDF-Erstellung).

Wenn ein hochgeladenes Bild sehr groß ist (größer als 1000×2000 Pixel),wird es verkleinert, um die Speichergröße des PDFs nicht zu sehr anwachsen zu lassen.

Für jeden Abschnitt eines Antragstyps ist es nun möglich, festzulegen, ob der Titel explizit im PDF gedruckt wird oder nicht.

Wenn man verschiedene Antragstypen definiert, kann man nun festlegen, dass bestimmte dieser Typen einen standardisierten Anfang im Titel haben,wie z.B. „Bewerbung: “.

Beim Erstellen eines Antrags zeigt die Bestätigungsseite nun eine Vorschau des erzeugten PDFs an.

Verfahrensvorschläge

Verfahrensvorschläge existieren schon eine Weile in Antragsgrün. Jedoch handelt es sich dabei um eine Funktion, die sehr auf professionelle Konferenz-Settings ausgelegt ist. Da diese Funktionalität oftmals gar nicht benötigt wird, sind Verfahrensvorschläge nun pro Antragstyp optional. Sie sind zudem standardmäßig deaktiviert.

Beim ODS-Export der Liste von Verfahrensvorschlägen besteht nun die Auswahlmöglichkeit, auch die Kommentare einzubinden oder nur öffentlich sichtbare Verfahrensvorschläge einzubeziehen.

Informationsmails über die Verfahrensvorschläge können nun vom/von der Absender*in angepasst werden.

Wenn ein Änderungsantrag durch einen anderen Änderungsantrag obsolet wird, wird diese Änderung auch im Zusammenhang mit dem vorgeschlagenen (obsoleten) Änderungsantrag ausgewiesen.

Administrator*innen können einen Vorschlag als vom/von der Benutzer*in akzeptiert kennzeichnen – das wird protokolliert.

Zudem wurden Fehler behoben, u.a. war es bislang nicht möglich, Admin-Kommentare zur vorgeschlagenen Vorgehensweise zu löschen.

Bessere Nachvollziehbarkeit beim Einarbeiten von Änderungsanträgen

Im Modus »Änderungsanträge einpflegen« (Visualisierungsansicht) zeigt Antragsgrün alle Änderungsanträge direkt in den Antragstext eingebettet an. Diese Ansicht kann nun als PDF exportiert werden, um den Zusammenführungsprozess zu dokumentieren.

Nach der Erstellung des endgültigen Texts kann nun ausgewählt werden, ob die neue Version dieses Antrags als regulärer Antrag oder als(vorläufige) Resolution dargestellt wird (Infos zum neuen Status »Resolution« siehe oben).

Außerdem wurde ein kleiner Fehler behoben, der das Einarbeiten von Änderungsanträgen mit bestimmtem Status verhindert hatte.

Weitere Änderungen und Fehlerbehebungen

Antragsgrün erlaubt schon lange, die Nutzeroberfläche und Meldungen über das Backend anzupassen. Dies ist z.B. für organisationsspezifische Ausdrücke und Formulierungen besonders nützlich. Neu ist nun, dass die übersetzbaren Zeichenketten intern mit einem Kommentar oder einer Beschreibung versehen werden können, um die Anpassung/Handhabung für Kolleg*innen zu erleichtern.

Beider Nutzerregistrierung gibt es nun die Option, eine E-Mail-Bestätigung für die neuen Nutzer*innen anzufordern.

Die Geschwindigkeit der tabellarischen Antragsübersicht im Backend wurde insbesondere für große Einsätze mit über vielen Änderungsanträgen verbessert, indem die Anzahl der einzelnen Datenbankabfragen reduziert werden konnte.

Die Admin-Oberfläche zum Hinzufügen/Entfernen von Unterstützer*innen eines Antrags hat nun die Funktion, die vollständige Liste der Unterstützer*innen in einem Format in die Zwischenablage zu kopieren, das geeignet ist, sie später in das Volltextfeldeinzufügen (um die Unterstützer*innen-Liste einfach von einem Antrag in einen neuen zu übertragen).

Und schließlich wurden Fehler der Vorgängerversion behoben. Dazu gehören z.B.:

  • Zu lange Antragstitel konnten zu fehlerhafter Seitengenerierung führen.
  • Unter bestimmten Umständen schien ein einem Tagesordnungspunkt zugeordneter Antrag auf der Übersichtsseite der Veranstaltung nicht korrekt zugeordnet zu sein.
  • Wenn ein Antragstyp von Grund auf neu erstellt und dabei rechts positionierte Antragsabschnitte hinzugefügt wurden, wechselte das Layout nicht in den zweispaltigen Modus.
  • Der LaTeX-basierte PDF-Export funktionierte nicht, wenn ein eigentlich optionales Bild nicht hochgeladen war.

Updaten? Am besten bald!

Wir empfehlen euch bald auf die neue Antragsgrün-Version zu aktualisieren. Das klappt bequem per Web-Updater. In diesem Zusammenhang möchten wir euch darauf hinweisen, dass Antragsgrün mittlerweile auf die PHP-Version 7.2 optimiert ist. Falls euer Server diese Version bereits unterstützt (bei vielen Providern kann man das im Administrationspanel per Mausklick einstellen), empfehlen wir euch aufgrund von Geschwindigkeits- und Sicherheitsvorteilen diese Aktualisierung ebenfalls.

Wer Antragsgrün neu installieren möchte, erhält die jeweils aktuellste Version über die Entwicklungsseite von Antragsgrün auf Github: https://github.com/CatoTH/antragsgruen/releases/latest

Fehlerbehebungen für Antragsgrün 4.0.x

Seitdem Antragsgrün 4 Anfang September offiziell erschien, wurden einige Fehler entdeckt (und behoben). Aktuell ist derzeit Antragsgrün 4.0.4. Wir empfehlen das zeitnahe Einspielen – mittlerweile ganz bequem über den Web-Updater ;-).

Visualisierungsansicht »Änderungsanträge einpflegen«

Ein kleiner, aber lästiger Fehler wurde behoben: Gelegentlich waren die Übernehmen/Verwerfen-Buttons im Visualisierungsmodus nicht mehr verschwunden und überlagerten den sichtbaren Text während der Live-Antragsberatung. Das sollte nun behoben sein.

Technische Basis und Export

Bei manchen Webhostern traten bei der Generierung von Exportdateien auf, da das /tmp/-Verzeichnis zugriffsbeschränkt ist. Daher werden diese Dateien nun temporär in /runtime/tmp/ abgelegt.
Zur Einrichtung der MariaDB-/MySQL-Datenbank ist nun auch möglich eine Portangabe möglich (wie „localhost:3306“). Kleinere Probleme bei der Datenbankerstellung wurden behoben.
Der eingebettete »CKEditor« wurde auf eine neue Version aktualisiert.
Mehrere Fehler bei der Generierung von PDFs wurden behoben, wie z.B. unterstrichener Text, Tabellendaten und die Zeilennummerierung bei Unteraufzählungspunkten.

So geht’s: Installation und Update

Das komplette (englische) Changelog befindet sich unter https://github.com/CatoTH/antragsgruen/blob/master/History.md. Ein fertiges Installationspaket kann heruntergeladen werden unter https://github.com/CatoTH/antragsgruen/releases. Diese Datei muss entpackt und in ein Verzeichnis bei eurem Webhoster transferiert werden. Beim ersten Aufruf des Verzeichnisses über euren Browser startet der Einrichtungsassistent, der die Datenbank und die erste Veranstaltung anlegt.

Wer von einer älteren Version von Antragsgrün auf die 4er-Linie aktualisieren möchte, sollte sich die Upgradebeschreibung unter https://github.com/CatoTH/antragsgruen/blob/master/docs/UPGRADING.md ansehen.

Die kommende Antragsgrün-Version 4.1 mit neuen Funktionen befindet sich bereits in der Betaphase und kann ebenfalls bereits von o.g. Quellen heruntergeladen und getestet werden.