Skip to main content

Kufuna Kufunsa Control Panel

Mwayi (Overview)​

Enhance ndi control panel yomodate yomwe imapereka ulemu wopereka hosting automation ndi kuwunika. Izi zinthu zimapereka kukhazikitsa m'mwayi wosonyeza domain ndi kusunga SSL certificate m'mwayi wopereka kwa Ultimate Multisite ndi Enhance Control Panel.

Kufotokozera Kofunsa: Onani GitHub Discussion #265 kuti mwayi wosamwamba womukulu (community tips) ndi mavuto ena.

Zomwe Zili​

  • Kukhazikitsa domain kwa m'mwayi poyenera m'Ultimate Multisite
  • Kusunga SSL certificate kwa m'mwayi monga LetsEncrypt pamene DNS imapereka
  • Kusungira subdomain kwa zinthu zomwe zimapereka m'subdomain mode
  • Kukhazikitsa domain pamene mappings zimaperekedwa
  • Kuthandiza kukhazikitsa m'mwayi kuti muwone kudziwa API credentials

Zomwe Zilimo (Requirements)​

Zomwe Zili za M'mwayi (System Requirements)​

  • Enhance Control Panel imapereka ndimene imaperekedwa
  • WordPress Multisite imapereka pamene imapereka m'server ya Enhance kapena imapereka poyenera nayo

Kukhazikitsa API Access​

Mukuphunzira kuti muli ndi ulemu wopereka (administrator access) kwa Enhance Control Panel kuti mupereke API tokens.

Kuperekera API Credentials Yanu​

1. Kukhazikitsa API Token​

  1. Kodi muli ndi ulemu wopereka (administrator) m'Enhance Control Panel?
  2. Onani Settings m'navigation menu.
  3. Onani Access Tokens.
  4. Onani Create Token.
  5. Pempani m'token lina dzina lomwe limapereka (mwachitsanzo, "Ultimate Multisite Integration").
  6. Pempani role ya System Administrator.
  7. Kwa tsiku lomwe imaperekedwa:
    • Pempani m'mwayi omwe si imaperekedwa (leave empty) kungakhale mukufuna kuti token simukuperekedwe.
    • Kapena pempani tsiku lomwe limaperekedwa kwa anthu kuti muli ndi chidziwitso.
  8. Onani Create.

Pambere pa muli, Access Token na Organization ID pa utendeka. Sazakani ngati muli monga momwe, chifukwa token si utendeka pafupi.

2. Get Your Organization ID​

Organization ID utendeka pa Access Tokens page m'mbo wopambwa (blue information box) wopambwa "Org ID: {your_id}".

Organization ID ndi UUID yomwe yomwezi: d8554b6d-5d0d-6719-009b-fec1189aa8f3

Muli monga customer Organization ID m'mbo wopambwa:

  1. Tenda pa page ya Customers
  2. Kufuna Manage customer kwa customer wopambwa
  3. Muli monga URL - Organization ID ndi ma-alphanumeric characters pamwamba na /customers/

3. Get Your Server ID​

Kuti mutendeka Server ID (muli monga momwezi wokonzekera domain):

  1. Mu Enhance Control Panel, tenda pa Servers
  2. Kufuna server wopambwa womwe WordPress uliyo nalo
  3. Server ID (UUID format) utendeka mu URL kapena mu ma-details a server
  4. Muli monga momwezi wokonzekera API kuti mutendeka servers:
curl -s -X GET https://your-enhance-panel.com/api/servers \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" | jq

Server ID utendeka UUID format: 00000000-0000-0000-0000-000000000000

4. Get Your API URL​

API URL ya wanu ndi URL ya Enhance Control Panel yanu yomwezi ndi /api/ yopambwa:

https://your-enhance-panel.com/api/

Mkwiyo: Path ya /api/ ndi yopambwa. Malingaliro omwe muli monga momwezi:

  • Kutsatira domain pafupi pamwamba na /api/
  • Kutsatira HTTP pamwamba na HTTPS (HTTPS ndi yopambwa kuti muli wopambwa)

Configuration​

Required Constants​

Tsimikani constants zimene zifunika mu file wanu wp-config.php:

// Kufuna kuongeza Usimbizo wa Control Panel

define('WU_ENHANCE_API_TOKEN', 'your-bearer-token-here'); define('WU_ENHANCE_API_URL', 'https://your-enhance-panel.com/api/'); define('WU_ENHANCE_SERVER_ID', 'your-server-uuid-here');

Kufunga kwa Kutumia Integration Wizard​

  1. Mu admin ya WordPress, ndiupira Ultimate Multisite > Settings
  2. Uenda ku tab ya Integrations
  3. Utambira Enhance Control Panel Integration uliambike nazo Configuration
  4. Wizard utakufuna mambo yote:
    • Step 1: Kujitambulisha na maelezo ya sifa
    • Step 2: Ingiza credentials zako za API (Token, API URL, Server ID)
    • Step 3: Jaribu muunganisho
    • Step 4: Pitia na uweze kuwasha

Umaweza kuchagua:

  • Kuacha wizard uingize constants hizo moja kwa moja kwenye faili yako ya wp-config.php
  • Kunakili maelezo ya constants na kuziongeza mwenyewe

Usimbizo wa WordPress Unaongeza​

Kupitia maoni kutoka kwa jamii (Discussion #265), unaweza kuhitaji kufanya hizi mipangilio ya ziada:

Usimbizo wa .htaccess​

Kama unapata matatizo na jinsi domain inavyounganishwa (domain mapping):

  1. Futa faili asili la Enhance .htaccess
  2. Badilisha kwa faili la standard WordPress Multisite .htaccess

Ongeza constants hizi kwenye wp-config.php ili kuhakikisha cookie zinashughulikiwa vizuri katika domains zilizounganishwa:

define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST']);
define('COOKIEPATH', '/');
define('ADMIN_COOKIE_PATH', '/');

Jinsi Inavyofanya Kazi​

Wakati Domain Inapounganishwa (When a Domain is Mapped)​

  1. Muli wosombedi (user) amap custom domain m'Ultimate Multisite (opereka site lili ndi subdomain).
  2. Integration imapeto POST request ku Enhance API: /servers/{server_id}/domains
  3. Enhance imapanga domain iwo ku server configuration yanu
  4. Pamene DNS imapita ku server yanu, Enhance imapanga SSL certificate m'LetsEncrypt kwawo
  5. Domain imapereka ndi HTTPS

Pamene Domain Imalimbidwa (When a Domain is Removed)​

  1. Mapeto domain mapping m'Ultimate Multisite
  2. Integration imapanga Enhance kuti ipe ID ya domain
  3. DELETE request imapeto ku: /servers/{server_id}/domains/{domain_id}
  4. Enhance imalimbidwa domain ku server configuration yanu

Kufotokozera DNS ndi SSL Checking (DNS and SSL Checking)​

Ultimate Multisite imapereka zinthu zomwe zimapereka kuti muli woyamba DNS ndi SSL checking:

  • Muli ndi ulemu wopereka check interval m'Domain Mapping Settings (mwachidule: 300 seconds/5 minutes)
  • System imapanga DNS imapita pansi pansi pansi pansi pamene imalimbidwa domain kuti iyenera kukhala active
  • Validity ya SSL certificate imapereka m'mwayi
  • Enhance imalimbidwa SSL automatically, chifukwa chiyenera kukonza SSL manually si yofunikira

Kufotokozera Setup (Verifying Setup)​

Kufotokozera Connection (Test the Connection)​

  1. M'Integration Wizard, gulu step ya Test Connection
  2. Plugin imapanga kuti imapereka list ya domains ku server yanu
  3. Message ya m'mwayi imapereka:
    • API credentials ndi zikhalanso
    • API URL imapereka
    • Server ID ndi lili lolimba
    • Permissions zimapereka bwino

Pamene Muli Wopereka Domain (After Mapping a Domain)​

  1. Mapeto test domain m'Ultimate Multisite
  2. Kufotokozera logs ya Ultimate Multisite (Ultimate Multisite > Logs > integration-enhance)
  3. Kufotokozera m'Enhance Control Panel kuti domain imapereka:
    • Penda ku Servers > Your Server > Domains
    • Domain yanu yatsopano imapereka m'list

Once DNS imapita, ufotokozera SSL imapereka m'mwayi

Kufunsa (Troubleshooting)​

Matenda a API Connection Issues​

Error: "Failed to connect to Enhance API"

  • Tsintha WU_ENHANCE_API_URL kuphunzitsa /api/ ku mutengo.
  • Kuphunzitsa kuti utaphunzira HTTPS, osati HTTP.
  • Tsintha kuti panel ya Enhance imakubwera ku server ya WordPress yako.
  • Tsintha kuti kuli ndi rules za firewall zomwe zimapanga kukonera.

Error: "Enhance API Token not found"

  • Tsintha kuti WU_ENHANCE_API_TOKEN ikhudza m'config ya wp-config.php.
  • Tsintha kuti token si yomwe yali yoperekedwa kapena yosakwera mu Enhance.
  • Tsintha kuti pali chidziwitso (typos) m'token.

Error: "Server ID is not configured"

  • Tsintha kuti WU_ENHANCE_SERVER_ID ikhudza m'config ya wp-config.php.
  • Tsintha kuti Server ID ndi mu format wopereka UUID.
  • Tsintha kuti server imakwanira kuwepo m'Enhance panel yanu.

Domain Siyaperekedwa (Domain Not Added)​

Tsintha logs:

  1. Tsintha ku Ultimate Multisite > Logs
  2. Filter ndi integration-enhance
  3. Tsintha kuti pali mapeto omwe amagwira ntchito za ndalama.

Zomwe zimakwanira kuchitika kwambiri:

  • Format ya ndalama yosakhala woperekedwa (Invalid domain name format).
  • Ndalama imakwanira kuwepo m'Enhance.
  • Kusakwaniridwa kwa API (tsintha kuti token ndi System Administrator role).
  • Server ID si yomwe yomonera m'Enhance.

Matenda a SSL Certificate Issues​

SSL siyaperekedwa:

  • Tsintha kuti DNS imapereka ku IP ya server yanu.
  • Tsintha kuti ndalama imakwanira kuperekedwa bwino: nslookup yourdomain.com
  • Enhance imayenera DNS iperekedwe poyenera paipapo kuti iperekedwe SSL.
  • Kuperekedwa kwa SSL kumapereka nthawi ya 5-10 minutes poyenera DNS yoperekedwa.
  • Tsintha ku logs za Enhance Control Panel kuti pali mapeto omwe ali ndi SSL.

Kufunsa SSL Manually m'Enhance:

  1. Tsintha ku Servers > Your Server > Domains
  2. Tsintha ndalama yanu ndipo tsintha status ya SSL yake.
  3. Mumakwanira kukhudza kuperekedwa kwa SSL ngati mukuwoneka.

DNS Check Interval​

Mifondi ya domain au sertifikati za SSL zikachaka muda mrefu kuwasha:

  1. Nenda kwenye Ultimate Multisite > Settings > Domain Mapping
  2. Tafuta mipangilio ya DNS Check Interval
  3. Badilisha kutoka kiwango cha default cha sekunde 300 hadi thamani ndogo (chini zaidi: sekunde 10)
  4. Kumbuka: Vipimo vidogo vitapokea ukaguzi mara nyingi zaidi lakini vitakuwa na mzigo mkubwa kwenye server

Makosa ya Uthibitisho (Authentication Errors)​

Makosa ya HTTP 401/403:

  • Rudisha token yako ya API katika Enhance
  • Thibitisha kuwa token ina jukumu la System Administrator
  • Angalia kwamba token haijakwisha muda wake
  • Hakikisha unatumia Organization ID sahihi (ingawa kwa kawaida haihitajiki kwenye URL)

Uchambuzi wa Log​

Washa logging ya kina:

// Ongeza katika wp-config.php kwa debugging bora
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Kisha angalia logs hapa:

  • Ultimate Multisite logs: Ultimate Multisite > Logs
  • WordPress debug log: wp-content/debug.log
  • Enhance panel logs: Inapatikana kwenye kiolesura cha admin la Enhance

Marejeo ya API (API Reference)​

Uthibitisho (Authentication)​

Maombi yote ya API hutumia uthibitisho wa Bearer token:

Authorization: Bearer YOUR_TOKEN_HERE

Endpoints Zinazotumika Mara kwa Mara​

Ondoa Servers:

GET /servers

Ondoa Domains kwenye Server:

GET /servers/{server_id}/domains

Ongeza Domain:

POST /servers/{server_id}/domains
Body: {"domain": "example.com"}

Ondoa Domain:

DELETE /servers/{server_id}/domains/{domain_id}

Documentation Kamili ya API​

Documentation kamili ya API: https://apidocs.enhance.com

Mbinu Bora (Best Practices)​

Security​

  • Pangakira koma kule API tokens mu version control
  • Store tokens m' wp-config.php kovu kovu, kovu kovu kovu Git
  • Use tokens ndi mavuto omwe ali ndi ulemu (System Administrator kuti muli ndi kugwirizana kwa mpaka)
  • Set expiry dates za tokens zokhudza environments zomwe zimapangidwa
  • Rotate tokens m'maka

Performance​

  • Use default DNS check interval (300 seconds) kuti muwone kupitiliza pa API calls
  • Monitor resources za server ya Enhance pamene mukugwiritsa ntchito operations za domain zosiyanasiyana kwambiri
  • Consider staggering domain additions ngati muli ndi ku mapangidwa kwa domain zingapo m'maka

Monitoring​

  • Check logs za Ultimate Multisite m'maka kuti muwone mavuto a integration
  • Set up monitoring pamene domain zikuyenera kupangidwa (failed domain additions)
  • Verify SSL certificates kuti zimapangidwa bwino
  • Keep eye pa capacity ya server ya Enhance ndi mapangidwa za domain

Additional Resources​

Support​

Ngati muli ndi mavuto:

  1. Check Troubleshooting section pamwamba
  2. Review Ultimate Multisite logs
  3. Consult GitHub Discussions
  4. Contact Enhance support kuti muli ndi mavuto omwe ali ndi panel
  5. Create discussion yanu yanu yomwe ndi error logs zosiyanasiyana kuti muli ndi chithandizo cha community

Notes​

  • Iziwoni, ijiwera imwezi ya domain aliases kale; Enhance imapereka SSL kwa motorero.
  • Iziwera imwezi ya integration imapereka mapeto omwezi (custom domain mappings) ndi sites zomwe zili m'subdomain.
  • Mwayi wopereka www subdomain mumwezi wa Domain Mapping mungapeza kuti mupereke.
  • Enhance imapereka Apache configurations kale (LiteSpeed Enterprise imapereka).
  • Iziwera domain ku Ultimate Multisite zimapereka domain ku Enhance komwezi, koma zingakhale zikupereka SSL certificates poyamba.