WP Doc Reviewer:
zbiorowa korekta dokumentów
w WordPressie
Dedykowana wtyczka umożliwiająca społeczności zgłaszanie poprawek do długich dokumentów numerowanych – bez zewnętrznych narzędzi, bezpośrednio na stronie klienta.
Typ projektu
Wtyczka WordPress (custom)
Wersja
1.2.2
Klient
Organizacja (anonimowo)
Wykonanie
BGLinked
Klient – organizacja prowadząca aktywną społeczność – potrzebował narzędzia do zbiorowej weryfikacji obszernego dokumentu zawierającego ponad 500 punktów numerowanych. Dokument miał trafić do grupy odbiorców, którzy mieli możliwość zgłaszania własnych propozycji poprawek do poszczególnych akapitów.
"Istniejące rozwiązania (Google Docs, komentarze e-mailem, platformy ankietowe) nie spełniały wymagań: brak moderacji, brak integracji ze stroną, brak struktury per punkt."
Wymaganie było jasne: wszystko musi działać w ramach istniejącej strony WordPress — bez zewnętrznych serwisów, bez kont użytkownika po stronie uczestników, z pełną kontrolą administratora nad statusem każdej propozycji.
Rozwiązanie wykorzystane w projekcie
Zaprojektowaliśmy i zbudowaliśmy wtyczkę WP Doc Reviewer – kompletny system importu, prezentacji i moderacji dokumentów w WordPressie.
Import DOCX
Administrator wgrywa plik .docx przez panel WP. Wtyczka parsuje XML dokumentu, automatycznie rozpoznaje sekcje i numerowane punkty, zapisując je do własnych tabel w bazie danych.
Publikacja przez shortcode
Dokument pojawia się na dowolnej stronie/poście za pomocą prostego shortcode [doc_review slug="..."]. Widok punktów jest paginowany – jeden punkt na raz – ze spisem treści i nawigacją do konkretnego numeru.
Zgłaszanie propozycji
Użytkownik zaznacza fragment tekstu w danym punkcie. Formularz przechwytuje dokładne offsety zaznaczenia (start/end). Po wpisaniu imienia, nazwiska i e-maila – propozycja trafia do bazy ze statusem „oczekująca”.
Moderacja i eksport
Administrator widzi wszystkie propozycje w panelu z filtrowaniem. Każdą może zaakceptować, odrzucić lub usunąć. Całość exportuje jednym kliknięciem do CSV.
Kluczowe funkcje
- Parser DOCX — ekstrakcja numerowanych punktów i sekcji prosto z XML pliku Word
- Własne tabele SQL (dokumenty, punkty, propozycje) z indeksami dla wydajności
- Zaznaczanie fragmentu tekstu z przechwyceniem offsetów znakowych
- AJAX-owe wysyłanie i pobieranie propozycji bez przeładowania strony
- Duplikate-check — blokada wielokrotnego wysłania identycznej propozycji
- Moderacja trójstanowa: oczekująca / zaakceptowana / odrzucona
- Widoczność propozycji: publicznie tylko zaakceptowane, admin widzi wszystkie
- Spis treści sekcji z nawigacją do konkretnego punktu
- Narzędzie do przebudowy kolejności punktów dla już zaimportowanych dokumentów
- Eksport do CSV z pełnymi metadanymi propozycji
- Ochrona
Szczegóły techniczne
Wtyczka działa jako samodzielny moduł WordPress — nie wymaga żadnych zewnętrznych zależności ani bibliotek. Całość oparta na natywnym API WordPressa.
PHP | MySQL / wpdbj | Query + AJAX | ZipArchive | WordPress REST | Shortcode API | wp_nonc edbDelta | CSV Export
Parser DOCX działa bez bibliotek zewnętrznych — otwiera plik jako archiwum ZIP, wyciąga word/document.xml i parsuje regex’ami strukturę paragrafów wraz ze stylami nagłówków. Specjalna logika subpunktów obsługuje zagnieżdżone listy w dużych blokach numerowanych.
Efekt prac nad aplikacją
Projekt pokazał, że rozbudowane narzędzie do zbiorowej edycji dokumentów może działać w pełni w ekosystemie WordPress — bez narzutu zewnętrznych platform, z zachowaniem pełnej kontroli klienta nad danymi i moderacją.
Kluczowym wyzwaniem technicznym było precyzyjne mapowanie offsetów zaznaczenia tekstu po stronie przeglądarki na pozycje znakowe w surowym tekście po stronie PHP – szczególnie przy dynamicznie wstawianych numerach porządkowych punktów.
Chciałbyś podobną aplikację?
Skontakuj się!
Poniedziałek – Piątek: 9:00 – 17:00
Sobota: 9:00 – 14:00
697 746 613
kontakt@bglinked.pl
