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/macplaneta-create/mikro-booking/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WordPress plugin do obsługi rezerwacji pokoi i miejsc noclegowych, z panelem admina w React, kalendarzem dostępności, iCal oraz integracją Google Calendar w modelu BYOK.
Najważniejsze funkcje
- Zarządzanie pokojami i łóżkami, w tym rezerwacje grupowe.
- Cennik per room i per bed, ceny weekendowe oraz mnożniki dla dzieci.
- Publiczny widget rezerwacji i karta pokoju z modalem.
- Publiczny kalendarz dostępności miesięcznej:
mikroplaneta_availability_calendar. - Powiadomienia email, pliki
.ics, cron i logi notyfikacji. - Backup i eksport CSV/SQL z panelu administratora.
- Health Check, onboarding i przygotowanie pod i18n / WordPress.org.
- Google Calendar eksport rezerwacji przez OAuth 2.0 BYOK.
Wymagania
- PHP 8.0+
- WordPress 6.0+
- Node.js 18+
- Composer
Szybki start
- Zainstaluj zależności PHP:
composer install - Zainstaluj zależności panelu admina:
cd admin npm install - Aktywuj wtyczkę w WordPressie.
- W trybie developerskim uruchom frontend admina:
cd admin npm run dev
Dokumentacja
- SZYBKI_START.md - skrócony start po polsku
- DEVELOPMENT.md - workflow developerski
- ARCHITECTURE.md - architektura i warstwy systemu
- ROADMAP.md - plan produktu i priorytety
- STATUS.md - główny stan projektu między sesjami
- NEXT_SESSION.md - najbliższe konkretne zadania
- DOCUMENTATION_WORKFLOW.md - proces utrzymania dokumentacji między sesjami
- RELEASE_CHECKLIST.md - główna checklista operacyjna release / wdrożenia
- QA_CHECKLIST.md - aktywna checklista ręcznych testów
- docs/API.md - REST API
- docs/DATABASE.md - baza danych
- docs/GOOGLE_CALENDAR_SETUP.md - konfiguracja Google Calendar
- docs/WPORG_RELEASE_CHECKLIST.md - checklista release pod WordPress.org
- docs/WP_REPO_REQUIREMENTS.md - zgodność z WordPress.org
Struktura repozytorium
mikro-booking/
├── core/ # logika backendowa, serwisy, repozytoria, migracje
├── rest-api/ # kontrolery i trasy REST API
├── public/ # frontend publiczny widgetów
├── admin/ # źródła React/TypeScript dla panelu admina
├── assets/ # zbudowane assety frontendu i admina
├── docs/ # dokumentacja techniczna
├── tests/ # testy integracyjne
└── tools/ # narzędzia serwisowe i maintenance
Status
Stan repozytorium po marcowych zmianach 2026:
- stabilizacja operacyjna jest domknięta,
- Google Calendar eksport jest w gałęzi main (wymaga testu zewnętrznego),
- kolejne priorytety to testy zewnętrzne, płatności MVP i synchronizacja iCal.
Licencja
GPL v3 or later