Fejlesztői útmutató

Hogyan kell dolgozni egy HelloWP által üzemeltetett Bedrock alapú WordPress oldallal - lépésről lépésre a fejlesztők számára.

Hogyan dolgozz egy HelloWP által üzemeltetett Bedrock alapú WordPress oldallal

Amit kapsz

Amikor egy HelloWP által üzemeltetett Bedrock oldallal kezdesz dolgozni, a következőket kapod:

Git repó URL - A projekt GitHub repójának elérhetősége
Hozzáférés a repóhoz - GitHub meghívó a szervezethez vagy a repóhoz
Működő fejlesztői környezet leírás - Hogyan indítsd el lokálisan

A repó már tartalmazza:

A teljes Bedrock struktúrát
Az összes szükséges bővítményt és témát
A konfigurációs fájlokat
A deployment beállításokat

Első lépések

1. Repó klónozása

git clone [email protected]:hellowpio/projekt-neve.git
cd projekt-neve

2. Függőségek telepítése

composer install

Ez letölti a WordPress core-t, az összes bővítményt és témát a composer.lock alapján.

3. Környezeti fájl létrehozása

cp .env.example .env

Szerkeszd a .env fájlt a saját lokális beállításaiddal (adatbázis, URL stb.).

4. Lokális fejlesztés indítása

A lokális fejlesztéshez szükséges beállításokat a repó README.md fájlja tartalmazza, mivel ez projektenként eltérhet.

Napi munkamenet

Módosítás elvégzése

# 1. Friss kód lekérése
git pull origin main

# 2. Függőségek szinkronizálása (ha változtak)
composer install

# 3. Dolgozz a kódon (téma, bővítmény, konfiguráció)

# 4. Változások stage-elése
git add web/app/themes/tema-neve/

# 5. Commit leírással
git commit -m "feat: termékoldal redesign mobil nézethez"

# 6. Push a távoli repóba
git push origin main

Commit üzenetek formátuma

Használd a következő prefixeket:

Prefix	Mikor használd
`feat:`	Új funkció hozzáadása
`fix:`	Hibajavítás
`update:`	Meglévő funkció módosítása
`style:`	Vizuális módosítás
`refactor:`	Kód átszervezés, funkció nem változik
`docs:`	Dokumentáció módosítás

Példák:

feat: WooCommerce egyedi szállítási módszer hozzáadása
fix: kosár oldal ár formázási hiba javítása
update: footer copyright évszám automatizálása

Mappastruktúra

Fejlesztőként a következő mappák érdekesek számodra:

projekt/
├── config/                     # WordPress konfiguráció
│   ├── application.php         # Általános beállítások
│   └── environments/
│       ├── development.php     # Fejlesztői beállítások
│       ├── staging.php         # Staging beállítások
│       └── production.php      # Éles beállítások
├── web/
│   └── app/                    # ← ITT DOLGOZOL
│       ├── themes/             # Témák
│       ├── plugins/            # Egyedi bővítmények (mu-plugins is lehet)
│       └── uploads/            # Feltöltött fájlok (NE COMMITOLJ IDE)
├── composer.json               # Függőségek listája
├── composer.lock               # Pontos verziók (MINDIG COMMITOLD)
└── .env                        # Lokális beállítások (NE COMMITOLD)

Branch stratégia

A HelloWP által üzemeltetett oldalakon a branch stratégia projektenként eltérhet. Az alapértelmezett:

Branch	Cél	Deploy
`main`	Éles kód	Automatikus deploy az éles szerverre
`staging`	Tesztelés (ha van)	Automatikus deploy a staging szerverre
`feature/*`	Fejlesztés alatt álló funkciók	Nincs automatikus deploy

# Új funkció fejlesztése
git checkout -b feature/uj-funkcio
# ... dolgozol ...
git push origin feature/uj-funkcio
# → Pull Request a main-be

Gyakori kérdések

Hol van a WordPress admin?

A Bedrock alapú oldalakon az admin felület a /wp/wp-admin/ útvonalon érhető el (nem a szokásos /wp-admin/ útvonalon).

Módosíthatom a WordPress core fájlokat?

Nem. A WordPress core a vendor/ és web/wp/ mappákban van, amelyeket a Composer kezel. Ezeket a mappákat nem szabad kézzel módosítani.

Mi történik push után?

A HelloWP szerverei automatikusan deployolják a kódot. A push utáni néhány másodpercen belül a változások megjelennek az éles (vagy staging) szerveren.

Segítséget kérhetek?

Igen! Ha bármiben elakadsz, keress minket a [email protected] címen. A HelloWP csapata segít minden Bedrock-kal kapcsolatos kérdésben.