Steckbriefe im UCP

Das Plugin ermöglicht es, unabhängig von Profilfeldern, Felder für den Steckbrief anzulegen. Diese werden in einem gesonderten Bereich im UCP angezeigt und können hier bearbeitet werden. Das Mitglied kann den Steckbrief bearbeiten und speichern und schließlich als fertig markieren und einreichen. Es wird automatisch ein Thread in der Steckbriefarea erstellt.

Ausfühlichere Erklärungen und Erweiterungen im Wiki!

https://github.com/katjalennartz/application_ucp/wiki

Updates

• forenadresse/update_application.php
• im Browser aufrufen

Update: September 2024

• version 1.1.4

• Aufteilung im UCP der Steckbrieffelder auf Wunsch im UCP, entweder mit oder ohne Tabs.

• Neue Variablen im Template application_ucp_ucp_main:
  vor {$footer} : {$application_ucpcats_js}{$application_ucp_js}
  nach <div class="applucp-con"> : {$cats_html}

• nicht vergessen das css hinzuzufügen!

• Updatescript UNBEDINGT(!) nötig, da es eine neue Tabelle, neue Settings und Datenbankfelder gibt.

Update: 2024

• version 1.1.3
• Durchsuchbarkeit in ACP
• Paginierung in ACP möglich
• Updatescript nötig, da es neue Settings gibt.

Update: Mai 2024

• version 1.1.2
• Optimierung Javascript für Abhängigkeiten - Checkboxen, Radiobuttons, Selects und Multiselects sollten jetzt gehen
• Einführung Triggerwarnung fürs Profil. Im ACP kann nun eingestellt werden, dass eine Triggerwarnung fürs Profil angegeben werden kann/soll
• Es kann nun pro Feld im ACP eingestellt werden, ob die Ausgabe vom reinen Text, bzw. Label von einem div oder span Element umklammert werden soll.
• Für die Einstellungen im ACP für den Thread, kann nun auch die Variable $aucp_fields verwendet werden, die den gesamten Stecki ausgibt.
• Updatescript nötig, da es neue Settings und Datenbankfelder gibt.

Update: 6.12.2023

• status angenommen in forumdisplay
• wob_date in user tabelle speichern
• javascript fixes

Update: 24.02.2023

• 'Speichern & Kontrolle' verstecken wenn angenommen
• Verlängern nur anzeigen, wenn noch nicht angenommen
• Templateänderung: application_ucp_ucp_main

<input type="submit" class="button" name="application_ucp_ready" value="{$lang->application_ucp_readybtn}"/>

ersetzen mit: {$savebtn}

version: 1.0.1
10.02.2023

• Möglichkeit mehr als eine Abhängigkeit hinzuzufügen
• Bugfixes: Vorallem bei der Anzeige der Mod Übersicht und Indexanzeige
• Möglichkeit im Thread anzuzeigen, welcher Mod die Korrektur übernommen hat. ( Variable: {$aucp_responsible_mod} )

8.1.2023 ->Update Script durchführen aus dem root verzeichnis, es gibt neue Felder in der Datenbank!

geplante Features: Automatische Listen - evt. als Add On Plugin

Wichtiger Hinweis. Um die Funktion nutzen zu können, dass die Mitgliederliste durchsuchbar ist, sind Änderungen in der memberlist.php nötig. Entweder die patches importieren (hier im gitlab) oder ganz am ende den Anweisungen folgen.

RPG Steckbriefsystem für MyBB.

• Erstellen von Steckbrieffeldern im ACP
• Ausfüllen der Felder im UCP (speichern oder einreichen)
• Export von Steckbriefen im Profil
• Anzeige der Felder im Profil und Postbit (entweder gesammelt, oder einzeln)
• Verwaltung der ausgefüllten Steckbriefe im ACP
• WoB im Thread erteilen und in Gruppe einteilen
• Optional bei WoB automatische Antwort
• Optional durchsuchen/filtern der Mitgliederliste nach den ausgefüllten Feldern

Einstellungen ACP

• Bewerbergruppe
• Steckbrief Frist
• Korrektur Frist
• Fristverlängerung (Tage)
• Fristverlängerung (Häufigkeit)
• Exportfunktion
• Area für die Steckbriefe
• Steckbriefthread (Vorlage)
• Charakter ein Gesuch?
• Charakter betrifft andere?
• Art der Benachrichtigung
• Moderatoren Gruppen
• Anzeige im Profil
• Anzeige im Postbit
• Anzeige in der Memberlist
• Antworttext WoB
• Antworttext WoB Inhalt
• Sollen Felder durchsuchbar sein (Mitgliederliste)

Templates

• application_ucp_index
• application_ucp_index_bit
• application_ucp_mods
• application_ucp_mods_bit
• application_ucp_wobbutton
• application_ucp_ucp_main
• application_ucp_filtermemberlist
• application_ucp_filtermemberlist_bit
• application_ucp_filtermemberlist_selectbit
• application_ucp_infos

Stylesheet

• application_ucp.css

Datenbank neue Tabellen:

• mybb_application_ucp_fields (die angelegten Felder)
• mybb_application_ucp_management (verwaltung für Steckbriefannahme)
• mybb_application_ucp_userfields (die ausgefüllten Daten der User)

eingefügte Spalten

• mybb_users : aucp_extend und aucp_extenddate

eingefügte Variablen

• index: {$application_ucp_index} (anzeige alert)
• member_profile: {$aucp_fields} (anzeige Felder profil)
• member_profile: {$exportbtn} (anzeige Export button)
• showthread: {$give_wob} (wob form)
• postbit: {$post['aucp_fields']} (anzeige Felder)
• postbit_classic: {$post['aucp_fields']} (anzeige Felder)
• memberlist: {$applicationfilter} (anzeige suchfelder) , {$filterjs} (Javascript für Suchvorschläge)

Links

• ACP Übersicht der Felder: boardadresse/admin/index.php?module=config-application_ucp
• Feld erstellen: boardadresse/admin/index.php?module=config-application_ucp&action=application_ucp_add
• Steckbriefe verwalten: boardadresse/admin/index.php?module=config-application_ucp&action=application_ucp_manageusers
• UCP: boardadresse/usercp.php?action=application_ucp
• Mod Übersicht: boardadresse/misc.php?action=aplication_mods

Felder im ACP und ihre Funktionen

Hier werden die verschiedenen Einstellungen der Felder im ACP erklärt

Step 1 - Installation

Hier findet ihr eine kleine Erklärung, wie das Plugin funktioniert und wie ihr am Besten startet.

1. Als aller erstes alle Dateien aus dem Upload Ordner hochladen. (Achtung, ich stelle gerade nur die Sprachdateien für deutsch_du zur Verfügung.)
2. Die memberlist.php anpassen. Entweder importiert ihr einfach den Patch, den ich zur Verfügung stelle (wenn ihr das Patches Plugin installiert habt), oder folgt der Anleitung in der Readme.md
3. Einstellungen im ACP vornehmen (Konfiguration -> Einstellungen: admin/index.php?module=config)
4. Steckbrieffelder erstellen (Konfiguration -> Steckbrief Einstellungen: admin/index.php?module=config-application_ucp )
5. Jetzt sollten man im User CP die Steckbriefe ausfüllen können.

Je nach Einstellungen, die ihr getroffen habt, müsst ihr die Felder selbst einbauen, oder sie werden ausgegeben. Die Variablen dafür findet ihr in der Übersicht (Steckbrief Einstellungen)

Erklärung der Felder

• Name des Felds:
  • Diese Bezeichnund wird in der Datenbank gespeichert, um das Feld später ansprechen zu können. Keine Sonderzeichen, keine Leertasten, am besten alles kleingeschrieben. Diese Bezeichnung dient nur als Identifikator
• Label des Felds:
  • Das Label ist das, was auch dargestellt wird. Also zum Beispiel 'Vorname'.
• Beschreibung des Felds
  • Die Beschreibung für das Feld.
• Typ des Felds:
  • Was für ein Inputfeld soll das Feld sein. Ein einfaches Textfeld, eine Textarea, Select, Multiple-Select, Date, Radio oder Checkbox..
• Auswahloptionen des Felds:
  • Dieses Feld ist nur auszufüllen, wenn ihr als Typ einen ausgewählt habt, der eine Auswahl stellt. Mit Komma getrennt, tragt ihr hier die Auswahlmöglichkeiten ein, die der Charakter haben soll.
• Pflichtfeld:
  • Hier bestimmt ihr ob dieses Feld ein Pflichtfeld ist oder nicht.
• Editierbar:
  • Hier bestimmt ihr ob dieses Feld nach der Annahme, bearbeitet werden darf oder nicht.
• Abhängigkeit:
  • Soll das Feld nur erscheinen, wenn in einem vorherigen Select, Multi-Select, Checkbox, Radiobutton ein bestimmter Wert (z.B. Schule = Hogwarts) ausgewählt ist, wählt ihr hier das Feld aus.
• Abhängigkeitswert:
  • Hier bestimmt ihr, von welchem Wert (also z.B. Hogwarts) das Feld genau abhängt. (Muss genau(!) der Option entsprechen)
• Anzeige im Profil:
  • Soll das Feld im Profil angezeigt werden? (wenn nein, können die Felder individuell dargestellt werden, Variablen dafür sind in der ACP-Übersicht zu finden)
• Anzeige im Postbit:
  • Soll das Feld im Postbit angezeigt werden? (wenn nein, können die Felder individuell dargestellt werden, Variablen dafür sind in der ACP-Übersicht zu finden)
• Vorlage:
  • Soll das Feld eine Vorlage enthalten. Also z.B. einen HTML code.
• HTML erlaubt?
  • Soll HTML erlaubt sein
• MyBB-Code erlaubt?
  • Soll MyBB-Code erlaubt sein
• IMG-tag erlaubt?
  • Sind Bilder erlaubt?
• Videos erlaubt?
  • Dürfen Videos eingefügt werden?
• Durchsuchbar:
  • Hier könnt ihr angeben, ob in der Mitgliederliste nach dem Feld gesucht werden soll.
• Suchvorschläge?
  • Sollen, wenn das Feld durchsuchbar ist, Vorschläge gemacht werden, mit Werten die von anderen Charakteren ausgefüllt sind.
• Reihenfolge:
  • Hier bestimmt ihr an welcher Stelle das Feld angezeigt werden soll (0 ganz oben).
• Gast
  • Dürfen Gäste das Feld sehen?
• Alternativer Inhalt für Gäste
  • Alternativer Inhalt für Gäste
• Aktiv?
  • Hier stellt ihr ein, ob das Feld aktiv sein soll. Deaktiviert ihr es, wird es nicht mehr angezeigt, die DB Einträge werden aber anders als beim Löschen behalten

---

Globale Variablen.

Für den user der aktuell Online ist, zum Beispiel in der Headertabelle:

Ausgabe: $ucp_data['fieldname'] Fieldname von dem Feld, das ausgegeben werden soll.

---

Mitgliederliste bearbeiten für Durchsuchbarkeit.

ich empfehle einfach die patches zu importieren
ansonsten
suche:

$query = $db->simple_select("users u", "COUNT(*) AS users", "{$search_query}"); 

ersetzen mit:

$query = $db->query("SELECT count(*) as users 
	FROM ".TABLE_PREFIX."users u 
	LEFT JOIN ".TABLE_PREFIX."userfields f ON (f.ufid=u.uid)
	{$selectstring}
	WHERE {$search_query} ");

suche nach:

$query = $db->query("SELECT u.*, f.* FROM ".TABLE_PREFIX."users u
LEFT JOIN ".TABLE_PREFIX."userfields f ON (f.ufid=u.uid)
WHERE {$search_query}
ORDER BY {$sort_field} {$sort_order}
LIMIT {$start}, {$per_page}"); 

ersetzen mit:

$query = $db->query("SELECT u.*, f.* {$selectfield} FROM ".TABLE_PREFIX."users u
	LEFT JOIN ".TABLE_PREFIX."userfields f ON (f.ufid=u.uid)
	{$selectstring}
	WHERE {$search_query}
	ORDER BY {$sort_field} {$sort_order}
	LIMIT {$start}, {$per_page}");