# Te Whakahaere i te Rapu me te Whakakapi i tō Pātengi Raraunga WordPress

Source: https://support.kapsulehost.com/mi-nz/wordpress-search-replace

Ka penapena a WordPress i ngā URL tūturu ki ngā tūtohi pātengi raraunga maha, nā reira ka waiho e tētahi huringa rohe, e tētahi nekehanga SSL rānei ngā wāhitau tawhito kua marara puta noa i ngā pou, ngā kōwhiringa me ngā tautuhinga mono: ko te rapu me te whakakapi te huarahi e horoi haumaru ai koe i aua mea. Ka kōrero tēnei aratohu mō ngā huarahi e rua e tautokona ana hei mahi i tēnei i KPanel, he aha i whakakino ai tētahi huarahi tuatoru e mōhiotia whānuitia ana i ngā raraunga, me te manatoko i te hua.

## Āhea e Hiahiatia ai

- Te neke mai i `http://` ki `https://` i muri i te whakahohe i te SSL.
- Te huri rohe, hei tauira, mai i `old-brand.co.nz` ki `new-brand.co.nz`.
- I muri i te pana i te staging ki te whakaputanga, ina kei roto tonu te ingoa kaihautū staging i te pātengi raraunga.
- Te whakamutu i tētahi kaihautū rawa tawhito me te tohu anō i ia URL whakaahua i te wā kotahi.
- Te whakatika i tētahi hapa tuhi puta noa i ngā pou maha, pērā i tētahi nama waea tawhito, i tētahi ingoa hua kua whakamutua rānei.

> **Warning:** Ka tuhi anō te rapu me te whakakapi i ngā rārangi puta noa i ia tūtohi i te wā kotahi, ā, kāore he whakakore mō ia rārangi. Tangohia he tārua i mua i tō tīmata, i ia wā, ahakoa mō tētahi huringa e āhua iti ana. Ka waihanga aunoa a KPanel i tētahi ina whakamahi koe i ngā taputapu kua hangaia kei raro e whakamāramatia ana, engari mēnā kei te whakahaere koe i te whakahau māu anō, māu tērā e tiaki. Tirohia [Te Tango Tārua](https://support.kapsulehost.com/mi-nz/taking-a-backup).

## He Aha e Kore ai e Taea te Whakahaere Noa i tētahi SQL REPLACE

Koinei te hapa kino rawa i ngā mahi pātengi raraunga WordPress, nā reira he pai kia mārama i mua i tō kōwhiri huarahi.

Ka penapena a WordPress i ngā tautuhinga mono, ngā kōwhiringa kaupapa me ngā raraunga widget hei aho PHP kua rangatūtia (serialised). Ka tuhi tētahi aho kua rangatūtia i te roa o ia uara kei roto, pēnei:

```
a:1:{s:3:"url";s:26:"http://old-domain.co.nz/x";}
```

E kī ana taua `s:26` e 26 ngā pūāhua o te URL. Whakakapia te `http://` ki te `https://` mā tētahi SQL `REPLACE()` noa, ā, ka 27 ngā pūāhua o te kuputuhi, engari e kī tonu ana te roa kua penapenatia e 26. Kātahi ka whakakāhore te PHP ki te wewete i te kōwhiringa katoa, ā, ka hoki puku te tautuhinga ki te tahanga. Ka ngaro ngā tautuhinga whakarite kaupapa, ka ngaro ngā kiriata o ngā slider, ka wetewete ngā raihana mono i a rātou anō.

Ko te WP-CLI search-replace e whakahaerehia ana e KPanel ka wewete i ia uara, ka whakakapi i roto, ka rangatū anō me ngā roa kua whakatikaina. Koia te take ko tēnei anake te huarahi e tuhia ana i konei.

> **Important:** Kaua rawa e whakahaere i te `UPDATE wp_options SET option_value = REPLACE(...)`, i tōna ōrite rānei i phpMyAdmin, ki tētahi pātengi raraunga WordPress. Ka āhua pai, ka pūrongo i ngā rārangi kua pāngia, ā, ka whakangaro puku i ia tautuhinga kua rangatūtia i pāngia e ia. Kāore he whakatikanga, hāunga te whakaora i tētahi tārua.

## Huarahi 1: Te Kāri Rapu me te Whakakapi

Koinei te kōwhiringa tika mō te nuinga. E wātea ana i ia mahere WordPress.

1. Takiuru ki [KPanel](https://kpanel.kapsulehost.com), ā, pāwhiritia **Ngā Paetukutuku** i te tahua taha maui.
2. Pāwhiritia te pae.
3. Whakatuwherahia te ripa **WordPress**, kātahi te wāhanga **Ngā Mahi Tere**.
4. Kimihia te kāri **Rapu me te Whakakapi**, ā, pāwhiritia **Whirihora**.
5. Tāurutia te kuputuhi o nāianei ki **Rapua (uara tawhito)**.
6. Tāurutia te kuputuhi hōu ki **Whakakapia ki**.
7. Waiho kia tohua a **Whakamātautau (arokite anake, kāore he huringa)**, ā, pāwhiritia **Arokite**.

![Te kāri Rapu me te Whakakapi i Ngā Mahi Tere o KPanel](https://support.kapsulehost.com/help/screenshots/wordpress-search-replace.d3d0a573.webp)

Ka pūrongo te whakamātautau i te maha o ngā whakakapinga ka mahia, ā, ka wāwāhi i te tatau mā te tūtohi me te tīwae, kia kite tika ai koe i te wāhi ka tau te huringa i mua i tō whakaū.

Ina tika te āhua o te arokite:

1. Tangohia te tohu i **Whakamātautau**.
2. Pāwhiritia **Whakahaere**.
3. Whakaūngia te matapihi.

Ka tangohia aunoatia he tārua katoa i mua i te tīmatanga o te whakakapinga, ā, ka kapi te mahi i ngā tūtohi katoa, tae atu ki ērā i waihangatia e ngā mono.

> **Tip:** Rapua te aho tino motuhake e taea ana. Mā te whakakapi i `old-domain.co.nz` ka tuhi anō hoki i `mail.old-domain.co.nz` me `staging.old-domain.co.nz`, ā, he uaua kia koirā tāu e hiahia ana. Mā te whakauru i te kaupapa (scheme), pērā i `https://old-domain.co.nz`, ka whāiti tonu te ōritenga.

## Huarahi 2: WP-CLI mai i te Console

Ka hoatu e te console te pūkaha ōrite me te mana nui ake ki ngā haki. Ko ia tētahi o ngā wāhanga ka puta i ngā mahere whakahaere; i ētahi atu mahere ka whakaatu te rārangi ripa i tētahi hono **+8 on Managed** hei utu.

Whakatuwherahia te pae, kātahi **WordPress**, kātahi **Console**. Kua tīmata kē te tohu whakahau ki te `wp`, nā reira patohia anake te toenga o te whakahau.

Arokitea tuatahi:

```
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
```

Kātahi ka whakahaere tūturu:

```
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables
```

> **Warning:** Kāore te console e tango tārua mōu. Ka puta anake te tārua aunoa i mua i te mahi ina whakamahi koe i te kāri Rapu me te Whakakapi i te Huarahi 1. Mēnā ka whakahaere koe i te whakahau i konei, tangohia tuatahitia he tārua māu anō mai i te whārangi **Tuku Kōpī** o te pae.

Ngā haki whaihua:

| Haki | He aha tāna mahi |
|---|---|
| `--all-tables` | Ka whakauru i ngā tūtohi ritenga i waihangatia e ngā mono, kaua ko ngā tūtohi matua WordPress anake |
| `--dry-run` | Ka pūrongo i ngā mea ka huri, ā, kāore e tuhi i tētahi mea |
| `--precise` | Ka whakamahi i te PHP, kaua i te SQL, mō te whakakapinga. He pōturi ake, engari ka taea e ia ngā hanganga rangatū uaua |
| `--skip-columns=guid` | Ka waiho noa ngā GUID pou (tirohia i raro) |
| `--report-changed-only` | Ka whakapoto i te putanga ki ngā tūtohi i tino huri |

### He Kōrero mō ngā GUID

He tīwae `guid` tō ia pou WordPress. Ahakoa he rite ki tētahi URL, he tohu tautuhi kē, ehara i te hono, ā, ka whakamahia e ngā kaipānui whāngai hei mōhio mēnā kua kite kē rātou i tētahi tūemi. Mā te tuhi anō ka puta anō pea ia pou o tō whāngai hei mea hōu.

Tuhia anōtia ngā GUID ina huri pūmau koe i te rohe, ā, ka tīmata hōu. Pekea mā te `--skip-columns=guid` ina neke noa koe mai i te HTTP ki te HTTPS i runga i te rohe ōrite.

## Te Huri Rohe: Whakamahia kē te Kāri URL Pae

Mēnā ko te take katoa he neke i te pae ki tētahi rohe hōu, kaua e tīmata ki te rapu me te whakakapi. Ko te kāri **Huri i te URL Pae**, i te wāhanga **Ngā Mahi Tere** ōrite, ka whakahōu i ngā kōwhiringa `siteurl` me `home`, ā, ka whakahaere i te whakakapinga puta noa i ngā tūtohi katoa i te mahi kotahi, i te raupapa tika. Mā te mahi kōaro ka kore pea e taea e WordPress te uta i tōna ake whakahaere.

## I muri i te Whakakapinga

Mahia tēnei rārangi i mua i tō kī kua oti.

1. **Horoia te keteroki.** I te wāhanga **Ngā Mahi Tere**, whakahaerehia **Horoi Keteroki**. Mēnā e whakamahi ana te pae i te keteroki whārangi katoa, purea mai i **WordPress**, kātahi **Keteroki**.
2. **Horoia ngā ture tuhi anō.** Whakahaerehia **Horoi Tuhi Anō** i te wāhanga ōrite, whakatuwherahia rānei **Settings**, kātahi **Permalinks** i wp-admin, ā, pāwhiritia **Save Changes** me te kore e huri i tētahi mea.
3. **Purea te CDN** mēnā kei runga te pae, mai i **Mahi**, kātahi **Kapsule CDN**. Tirohia [Te pure i te keteroki Kapsule CDN](https://support.kapsulehost.com/mi-nz/cdn-cache-purge).
4. **Utaina te pae i tētahi matapihi tūmataiti** kia kore ai tō keteroki pūtirotiro e whakapōhēhē i a koe.
5. **Tirohia te raka.** Ko te raka kua ngaro, he whakatūpato rānei tōna i muri i tētahi nekehanga SSL, ko te tikanga i waiho ētahi URL: [Te Whakatika i ngā Whakatūpato Ihirangi Whakaranu](https://support.kapsulehost.com/mi-nz/ssl-mixed-content).
6. **Pāwhiri haere i ngā whārangi tīwekaweka.** Ngā slider o te whārangi kāinga, te moko o te pane, ngā whārangi i hangaia ki tētahi kaihanga whārangi, me te wāhi utu i tētahi toa. Kei ēnei ngā URL e noho ana i ngā kōwhiringa kua rangatūtia.
7. **Ūkuia ngā mono keteroki** mai i tōna ake mata tautuhinga.

## Te Rapu Rongoā

**E pūrongo ana te whakamātautau kāore he whakakapinga.** Kāore te aho i te pātengi raraunga i taua āhua tonu. Tirohia mō tētahi rītaha whakamutunga, mō tētahi kuhimua `www.`, mō te kaupapa (scheme) rānei. Whakamātauria kia rapu tuatahi i te ingoa kaihautū anake hei whakaū kei reira rawa.

**Kua pakaru ngā whakaahua i muri i tētahi huringa rohe.** Kei `wp_posts` me `wp_postmeta` ngā URL pāpāho, ā, ka hopukina e `--all-tables`, engari tērā pea ka keteroki tētahi CDN, mono whakarite whakaahua rānei i āna ake kape kua tuhia anōtia. Purea te CDN me te keteroki o te mono, kātahi ka uta anō.

**I ngaro ngā tautuhinga i muri i te whakakapinga.** Koinā te raru rangatū, ā, ko te tikanga i mahia te huringa mā te SQL mata, kaua mā ngā taputapu i konei. Whakaorangia te tārua i tangohia i mua i te mahi: [Te Whakaora mai i tētahi Tārua](https://support.kapsulehost.com/mi-nz/restoring-from-backup).

**Ka hoki tonu mai ngā URL staging.** He mea kei te whakakī anō i a rātou, i te nuinga o te wā he pana kua whakaritea, he kōwhiringa kua keterokitia rānei. Tirohia te rerenga mahi i [Te Whakamahi i te Staging: Te Pana me te Tō](https://support.kapsulehost.com/mi-nz/wordpress-staging-workflow), ā, kia mōhio kua tohua a **Tuhi Anō i ngā URL** ina pana koe.