Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/blokkfreak/custom-profile-builder/archive/refs/heads/main.zipCustom Profil-Builder for WordPress
Erweiterter Profilbuilder für WordPress zur Ergänzung von Redakteursprofilen um Mediathek-Avatare, strukturierte Metadaten, Social-Links und automatisierte Elementor Pro Template-Integration.
Motivation & Einsatzbereich
Standard-WordPress-Installationen binden Benutzer-Avatare ausschließlich über den externen Dienst Gravatar ein, was im europäischen Agentur- und Kundenkontext datenschutzrechtliche Fragen aufwirft. Zudem fehlen in Standard-Profilen strukturierte Felder für Autoreninformationen (Jobtitel, Social Links, Pronomen, Standort) sowie flexible Möglichkeiten, Autorenarchive und Autoren-Einzelseiten dynamisch zu gestalten.
Dieses Plugin bietet:
- Lokale Mediathek-Avatare: Gravatar-Ersatz direkt über den WordPress Media-Uploader.
- REST-API-fähige Meta-Felder: Alle Profildaten werden via
register_meta()für Headless-Szenarien und Page-Builder exponiert. - Elementor Pro Vorlagen-Integration: Automatisierter Import fertiger Vorlagen für Autoren-Archive und Profilseiten.
Architektur & Klassenstruktur
Das Plugin ist modular in objektorientierte Einzelklassen gegliedert:
custom-profile-builder/
├── assets/
│ ├── admin-profile.css # Styling der WordPress-Profilseite im Backend
│ └── admin-profile.js # Tab- und Accordion-Steuerung im Admin
├── includes/
│ ├── class-admin-profile-layout.php # Strukturierung der Profilbereiche
│ ├── class-author-redirect.php # Frontend-Override für Autoren-URLs
│ ├── class-avatar.php # Mediathek-Upload & Gravatar-Filter
│ ├── class-elementor-integration.php # Vorlagen-Import & Admin-Notices
│ ├── class-links.php # Dynamische benutzerdefinierte Linkliste
│ ├── class-profile-fields.php # Pronomen, Standort, Jobtitel & REST-Felder
│ └── class-social.php # 12 vordefinierte Social-Media-Profile
├── templates/
│ ├── author-archive.json # Elementor-Vorlage: Autoren-Archiv
│ └── single-author.json # Elementor-Vorlage: Autoren-Einzelseite
├── custom-profile-builder.php # Plugin Bootstrap & Initialisierung
├── LICENSE
└── README.md
Funktionsübersicht
1. Avatar-Verwaltung (CUSTOM_PB_Avatar)
- Bindet den nativen WordPress Media-Uploader auf
profile.phpunduser-edit.phpein. - Filtert
get_avatar_url, um bei vorhandenem Upload das lokale Bild anstelle von Gravatar zurückzugeben. - Speichert die Bild-URL im User-Meta-Key
CUSTOM_PB_avatar.
2. Erweiterte Profilfelder & REST API (CUSTOM_PB_Profile_Fields)
- Felder: Pronomen (
CUSTOM_PB_pronouns), Stadt/Land (CUSTOM_PB_location_city,CUSTOM_PB_location_country), Jobtitel (CUSTOM_PB_job_title), Unternehmen (CUSTOM_PB_company), Autoren-URL (CUSTOM_PB_author_url). - Alle Felder sind über
show_in_rest: trueim Core-REST-Endpunkt/wp-json/wp/v2/usersabrufbar.
3. Dynamische Linkliste (CUSTOM_PB_Links)
- Redakteure können beliebige Links mit individuellen Labels pflegen (Add/Remove per JavaScript).
- Ausgabe im Frontend über den Shortcode
[custom_profile_links].
4. Social-Media-Integration (CUSTOM_PB_Social)
- Unterstützt 12 Plattformen: LinkedIn, XING, X/Twitter, Instagram, Facebook, TikTok, YouTube, GitHub, Mastodon, WordPress.org, Twitch, Tumblr.
5. Elementor Pro Integration (CUSTOM_PB_Elementor_Integration)
- Erkennt eine aktive Elementor Pro Installation und bietet im Dashboard den 1-Klick-Import der Vorlagen
author-archive.jsonundsingle-author.jsonan. - Nutzt Elementors internen
templates_managerzur fehlerfreien Registrierung.
6. Autoren-Link Override (Custom_Author_Redirect)
- Überschreibt den Standard-Autorenlink über den Filter
author_link. - Enthält einen Footer-Fallback für das Elementor Post Info Widget, da Elementor den Filter in bestimmten Widgets intern umgeht.
Installation
- Den Ordner
custom-profile-builderin das Verzeichniswp-content/plugins/hochladen oder kopieren. - Das Plugin im WordPress-Adminbereich unter Plugins aktivieren.
- Unter Benutzer -> Profil stehen die neuen Felder und der Media-Uploader sofort zur Verfügung.
- Bei aktiver Elementor Pro Installation der Admin-Meldung zum Import der Templates folgen.
Tech Stack & Standards
- PHP 7.4+ / 8.0+ (Objektorientiert, PSR-orientierte Strukturierung)
- WordPress Core APIs (User Meta, REST API, Media Uploader, Shortcodes, Transients)
- Elementor Pro Core Integration (Templates Manager & Dynamic Tags)
- Vanilla JavaScript & CSS (Keine externen Frontend-Abhängigkeiten)
Lizenz
Lizenziert unter der GNU General Public License v2 oder neuer.