# Felhasználó aktiválása

> E-mailes fiókaktiválás regisztráció után: beállítások, e-mail sablon és helyettesítők, aktiváló hivatkozás, Felhasználók oldal és bejelentkezés.

A **Felhasználó aktiválása** funkcióval a WordPress-regisztrációk után az újonnan regisztrált felhasználók aktiváló e-mailt kapnak, és a bejelentkezés előtt rá kell kattintaniuk az abban lévő hivatkozásra.

## Így működik

1. Létrejön az új felhasználói fiók.
2. A Bricks eltárol egy generált aktiválókulcsot, és a felhasználót függőben lévőként jelöli.
3. A Bricks elküldi az aktiváló e-mailt az új felhasználó e-mail-címére.
4. Az aktiváló hivatkozás a beállított **Sikeres ellenőrzés oldalára** mutat, `user_id` és `activation_key` lekérdezési paraméterekkel.
5. Ha a felhasználó érvényes hivatkozást nyit meg, a Bricks törli az aktiválókulcsot, és aktívnak jelöli a felhasználót.
6. Ha az **Automatikus bejelentkezés aktiválás után** be van kapcsolva, a Bricks sikeres aktiválás után be is jelentkezteti.
7. Ha a hivatkozás érvénytelen, a Bricks a **Sikertelen ellenőrzés oldalára** irányít.
8. A függőben lévő felhasználók nem tudnak bejelentkezni: inaktív fiókról szóló hibaüzenetet kapnak.

Azok a felhasználók, akik a funkció bekapcsolása előtt jöttek létre, nem rendelkeznek aktiválási állapot-metaadattal, ezért a Bricks aktívnak tekinti őket.

## Beállítások

Nyisd meg a **Bricks → Beállítások → Általános** lapot, és görgess a **Felhasználó aktiválása** csoporthoz.

![A Felhasználó aktiválása beállításai: kapcsolók, oldalválasztók és az e-mail mezői](./kepek/funkciok-felhasznaloi-aktivalas-beallitas.webp)

*A Felhasználó aktiválása beállításai: kapcsolók, oldalválasztók és az e-mail mezői* (https://minta-bolt.hu/wp-admin/admin.php?page=bricks-settings)

A képen a **Felhasználó aktiválása** kapcsoló, az **Automatikus bejelentkezés aktiválás után** kapcsoló, a két oldalválasztó és a **Felhasználó aktiválása: E-mail-cím** csoport mezői látszanak.

| Beállítás | Mit csinál |
| --- | --- |
| **Felhasználó aktiválása** | Bekapcsolva az új felhasználóknak a regisztráció után e-mailben kell megerősíteniük a címüket. Bekapcsolás után a többi beállítás is elérhetővé válik. A funkció minden új regisztrációra vonatkozik, nem csak az űrlapelemen át beküldöttekre. |
| **Automatikus bejelentkezés aktiválás után** | Sikeres e-mail-ellenőrzés után automatikusan bejelentkezteti a felhasználót. |
| **Sikeres ellenőrzés oldala** | A sikeres aktiválás hivatkozásának oldala. A Bricks ide várja az aktiváló hivatkozást. Ha a felhasználó `user_id` és `activation_key` nélkül nyitja meg az oldalt, a Bricks simán megjeleníti. |
| **Sikertelen ellenőrzés oldala** | Ide kerül a felhasználó, ha az aktiválás meghiúsul, mert a felhasználóazonosító vagy az aktiválókulcs hiányzik vagy érvénytelen. |

Mindkét oldalnak közzétett oldalnak kell lennie.

### Az aktiváló e-mail

| Beállítás | Mit csinál |
| --- | --- |
| **Feladó e-mail-címe** | Opcionális feladócím. Ha üres, a WordPress szokásos `wp_mail_from` értéke érvényes. |
| **Feladó neve** | Opcionális feladónév. Ha üres, a WordPress szokásos `wp_mail_from_name` értéke érvényes. |
| **Tárgy** | Az e-mail tárgya. Ha üres, a Bricks az „Aktiváld a fiókodat” szöveget használja. |
| **E-mail tartalma** | Az e-mail törzse. Ha üres, a Bricks alapértelmezett aktiválási üzenetet küld („Kérlek, kattints az alábbi hivatkozásra a fiókod aktiválásához”, alatta a hivatkozás). |
| **HTML e-mail** | Az e-mailt HTML-ként küldi. Ha be van kapcsolva, és a tartalom nem teljes HTML-dokumentum, a Bricks az `nl2br()` függvénnyel alakítja a sortöréseket. |

Az e-mail tárgyában és tartalmában használható helyettesítők:

| Helyettesítő | Kimenet |
| --- | --- |
| `{{site_name}}` | A webhely neve |
| `{{site_tagline}}` | A webhely szlogenje |
| `{{site_url}}` | A webhely címe |
| `{{username}}` | A felhasználó belépési neve |
| `{{user_display_name}}` | A felhasználó megjelenített neve |
| `{{user_first_name}}` | A felhasználó keresztneve |
| `{{user_last_name}}` | A felhasználó vezetékneve |
| `{{user_email}}` | A felhasználó e-mail-címe |
| `{{activation_link}}` | Az aktiválási cím, HTML e-mail esetén kattintható hivatkozásként |
| `{{activation_url}}` | A sima aktiválási cím |

## Regisztráció közbeni viselkedés

A funkció bekapcsolt állapotban a WordPress `user_register` folyamatába kapcsolódik. Ezért érinti:

- a Bricks **Űrlap** elemén át regisztrált felhasználókat;
- minden más WordPress-regisztrációs folyamatot, amely kiváltja a `user_register` eseményt.

A Bricks **Űrlap** elem regisztrációs műveleténél:

- a művelet továbbra is ellenőrzi a felhasználónevet, az e-mail-címet, a jelszót, a jelszó hosszát és a szerepkört;
- biztonsági okból az Administrator és a Super Admin szerepkör nem lehet regisztrációs cél;
- ha a felhasználónév nincs hozzárendelve, a Bricks az e-mail-címből is képezhet egyet;
- ha a jelszó nincs hozzárendelve vagy beküldve, a Bricks generálhat egyet;
- a regisztráció utáni automatikus bejelentkezés kimarad, amíg a Felhasználó aktiválása be van kapcsolva.

Ha a regisztrációs űrlapműveletben be van kapcsolva a **WordPress-értesítés küldése**, a Bricks a felhasználó létrehozása után kiváltja a WordPress `register_new_user` műveletét. Az aktiváló e-mailt ettől függetlenül a Felhasználó aktiválása funkció küldi.

## Az aktiváló hivatkozás viselkedése

Az aktiválási cím a beállított **Sikeres ellenőrzés oldalából** és két lekérdezési paraméterből áll:

```
?user_id=123&activation_key=generált_kulcs
```

Amikor a kérés eléri a sikeres oldalt, a Bricks megvizsgálja a paramétereket:

- ha a `user_id` vagy az `activation_key` hiányzik, a sikeres oldal simán megjelenik;
- ha a `user_id` vagy az `activation_key` üres, a felhasználó a sikertelen oldalra kerül;
- érvénytelen aktiválókulcs esetén a felhasználó a sikertelen oldalra kerül;
- érvényes kulcsnál a fiók aktív lesz, és az aktiválókulcs törlődik;
- ha a felhasználó már aktív, a Bricks kihagyja az aktiválást, és simán megjeleníti a sikeres oldalt.

## A Felhasználók oldal

A WordPress **Felhasználók** oldalán új oszlop jelenik meg: **Aktiválási állapot (Bricks)**.

![A Felhasználók lista Aktiválási állapot oszlopa egy inaktív felhasználóval](./kepek/funkciok-felhasznaloi-aktivalas-felhasznalok.webp)

*A Felhasználók lista Aktiválási állapot oszlopa egy inaktív felhasználóval* (https://minta-bolt.hu/wp-admin/users.php)

A képen a lista utolsó előtti oszlopában az **Aktív** és az **Inaktív** állapot látszik, az inaktív felhasználó alatt a műveletekkel.

Lehetséges állapotok:

- **Aktív**: a felhasználó normálisan be tud lépni;
- **Inaktív**: a felhasználó aktiválása függőben van, és az aktiválásig nem tud belépni.

A felhasználó sorára víve az egeret az állapottól függő műveletek jelennek meg:

- aktív felhasználónál a **Megjelölés inaktívként** megakadályozza a belépést;
- inaktív felhasználónál az **Aktiváló e-mail újraküldése** új aktiváló hivatkozást küld az aktuális e-mail-sablonnal, a **Megjelölés aktívként** pedig e-mailes ellenőrzés nélkül, kézzel aktívvá teszi a felhasználót.

Az aktiválási állapotot és az újraküldést csak a WordPress `edit_users` jogosultságával rendelkező felhasználók módosíthatják a Felhasználók oldalon.

## Bejelentkezés

Amikor egy függőben lévő felhasználó megpróbál belépni, a Bricks megakadályozza a hitelesítést, és inaktív fiókról szóló hibaüzenetet jelenít meg. Az **Aktív** állapotú, valamint a funkció bekapcsolása előtt létrejött, állapot nélküli felhasználók normálisan beléphetnek.

Ha az [Egyéni hitelesítési oldalak](https://hub.hellowp.io/hu/plugins/bricks-child/funkciok-hitelesitesi-oldalak/) funkciót is használod, ugyanez az aktiválási ellenőrzés érvényes a Bricks **Felhasználó bejelentkezése** űrlapműveletére is, mert az a WordPress hitelesítését használja.

## E-mail testreszabása szűrőkkel

Az e-mail beállításai programozottan is módosíthatók ezekkel a szűrőkkel:

- `bricks/user_activation_email/from_name`
- `bricks/user_activation_email/subject`
- `bricks/user_activation_email/content`

Ezek többnyelvű webhelyeknél vagy olyan projekteknél hasznosak, ahol felhasználónként vagy környezetenként más e-mail-szöveg kell.