HandyCafe Docs
owner it-admin

Paano I-configure ang Client Desktop

Itinuturo ng gabay na ito kung paano buuin ang app menu na nakikita ng mga customer sa kanilang mga PC, mag-apply ng visual themes, i-set up ang idle screen, at mag-publish ng mga anunsyo. Ang bawat pagbabago na ginagawa mo sa server ay ipinapadala sa mga nakakonektang client kaagad sa pamamagitan ng TCP.

Paano Buuin ang App Menu

Ang app menu ang ginagamit ng mga customer habang nasa session. Ito ay nakaayos sa mga kategorya, na bawat isa ay naglalaman ng isa o higit pang mga app. Pinamamahalaan mo ang buong catalog mula sa server.

Kakailanganin Mo

  • HandyCafe Server na tumatakbo na may hindi bababa sa isang nakakonektang client.
  • Mga app executable na naka-install na sa mga client PC (para sa Game at App na mga uri).
  • Mga icon na larawan (PNG, JPG, o WebP) na handa para sa pag-upload. Ang inirerekomendang sukat ay 128x128 pixels.

Mga Hakbang

  1. Buksan ang HandyCafe Server application at pumunta sa Settings sa kaliwang sidebar.
  2. Piliin ang Clients na tab sa itaas, pagkatapos lumipat sa Content sub-tab.
  3. Sa Categories panel sa kaliwa, i-click ang Add Category na button.
  4. Maglagay ng pangalan ng kategorya tulad ng "Games" o "Browsers" at kumpirmahin. Lilitaw ang bagong kategorya sa listahan.
  5. Piliin ang kategoryang kakagawa mo. Sa kanang panel, i-click ang Add App.
  6. Punan ang mga detalye ng app. Maglagay ng Name (halimbawa "Counter-Strike 2"), opsyonal na Description, at itakda ang Kind sa naaangkop na uri: Game, Browser, Link, File, o App.
  7. Sa Executable Path na field, ilagay ang buong path ng application sa client PC. Halimbawa: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Para sa Link na uri, maglagay ng URL sa halip.
  8. Mag-upload ng icon sa pamamagitan ng pag-click sa icon area. Maaari kang mag-paste ng URL para kumuha ng larawan mula sa web o mag-browse ng lokal na file sa iyong makina. Ang icon ay lilitaw sa client app grid.
  9. Opsyonal na mag-upload ng Poster Image para sa mas mayamang visual na card. Ito ang malaking artwork na ipinapakita sa mga poster-first na display mode. Maaari mo ring i-enable ang Hero Carousel toggle para itampok ang app na ito sa rotating banner sa tuktok ng client desktop.
  10. I-drag ang mga item sa category list o app list para i-reorder ang mga ito. I-toggle ang visibility switch sa tabi ng anumang app para itago ito nang hindi tinatanggal. I-click ang Save kapag tapos na.

Inaasahang Resulta

Ang lahat ng nakakonektang client desktop ay mag-a-update sa loob ng ilang segundo. Lilitaw ang bagong kategorya at mga app sa client app grid. Maaaring i-launch ng mga customer ang mga app sa pamamagitan ng pag-click sa kanilang mga card.

Mga Karaniwang Mali

  • Paglalagay ng path na hindi umiiral sa client PC. Lilitaw ang app card ngunit mabibigo ang pag-launch. Palaging i-verify ang executable path sa aktwal na client machine.
  • Pagkalimot na i-save pagkatapos gumawa ng mga pagbabago. Hindi ipinadadala sa mga client ang mga hindi na-save na edit.
  • Paggamit ng napakalaking larawan nang walang compression. Bagaman gumagana ang anumang resolution, ang mga larawang mas malaki sa 512x512 ay nagpapabagal ng sync nang walang visual na benepisyo sa laki ng card.

Paano I-set ang Desktop Theme

Ang mga theme ay kumokontrol sa pangkalahatang hitsura ng client desktop habang nasa session. Pinipili mo ang color theme, layout preset, card density, at background settings.

Kakailanganin Mo

  • HandyCafe Server na tumatakbo.
  • Para sa background ng larawan o video: mga media file sa PNG, JPG, WebP, MP4, o WebM na format.

Mga Hakbang

  1. Pumunta sa Settings > Clients > Appearance tab.
  2. Sa ilalim ng Theme, piliin ang isa sa mga available na color theme: Neon Arena (blue-purple gaming aesthetic), Crimson Pulse (red-dark tones), o Emerald Depth (green-teal palette). Mag-a-update ang preview habang gumagawa ka ng mga pagpili.
  3. Sa ilalim ng Layout Preset, piliin kung paano nakaayos ang content sa screen. Ang mga opsyon ay Split Classic (mga kategorya sa kaliwa, mga app sa kanan), Hero Wide Top (malaking hero carousel sa itaas, mga app sa ibaba), Catalog Wide Bottom (compact hero, mas malawak na app grid), o Compact Focus (minimal chrome, maximum app space).
  4. Itakda ang Card Density para kontrolin kung ilang app ang magkakasya sa screen nang sabay. Ang Large ay nagpapakita ng mas malalaking card na may mas maraming detalye. Ang Medium ay nagbabalanse ng sukat at dami. Ang Compact ay naglalagay ng pinakamaraming app bawat row.
  5. I-configure ang Background. Piliin ang uri: Solid (pumili ng kulay), Gradient (pumili ng dalawang kulay), Image (mag-upload ng file), o Video (mag-upload ng MP4/WebM). Para sa Image at Video na uri, i-adjust ang Overlay Opacity slider para palaimin ang background sa likod ng mga card, at ang Blur slider para payumin ito.
  6. I-click ang Save. Ang theme ay ipinapadala sa lahat ng nakakonektang client kaagad.

Inaasahang Resulta

Ang mga client desktop ay nagre-refresh na may bagong visual settings. Ang theme, layout, laki ng card, at background ay nag-a-update nang hindi nagre-restart ang mga client.

Mga Karaniwang Mali

  • Paggamit ng video background na may napakalalaking file size. Panatilihin ang mga video sa ibaba ng 20 MB para sa mabilis na sync. Ang mas matagal o mas mataas na resolution na mga video ay nagdudulot ng kapansin-pansing oras ng pag-load sa mga client PC.
  • Pagtatakda ng overlay opacity na napakababa sa isang abala-abalang background image. Nagiging mahirap basahin ang teksto at mga label ng card. Ang overlay na 40-60% ay gumagana nang maayos para sa karamihan ng mga larawan.

Paano I-configure ang Idle Screen

Ang idle screen ang nakikita ng mga customer kapag ang isang PC ay hindi ginagamit. Maaari itong magpakita ng slideshow ng mga larawan o video, isang orasan, at pangalan ng iyong cafe.

Kakailanganin Mo

  • Mga image file (PNG, JPG, WebP, o GIF) o video file (MP4, WebM) para sa slideshow.
  • HandyCafe Server na tumatakbo.

Mga Hakbang

  1. Pumunta sa Settings > Clients > Idle Screen tab.
  2. I-toggle ang Enable Slideshow sa on.
  3. I-click ang Add Media para mag-upload ng mga larawan o video. Maaari kang magdagdag ng maraming item. Ang mga suportadong format ay PNG, JPG, WebP, GIF, MP4, at WebM.
  4. Itakda ang Duration para sa bawat item sa mga segundo. Ito ay kumokontrol kung gaano katagal nananatiling visible ang bawat slide bago lumipat. Ang halaga sa pagitan ng 8 at 15 segundo ay gumagana nang maayos para sa karamihan ng mga setup.
  5. Pumili ng Transition effect: Fade (maayos na opacity crossfade), Slide (horizontal slide), o Zoom (scale-in effect).
  6. I-enable ang Clock Overlay toggle para magpakita ng digital na orasan sa idle screen. Gamitin ang color picker para itakda ang kulay ng teksto ng orasan para sa maximum na kontrasto laban sa iyong slideshow content.
  7. I-enable ang Cafe Name toggle para ipakita ang pangalan ng iyong negosyo sa idle screen. Ang pangalan ay kinukuha mula sa iyong mga pangkalahatang server settings.
  8. I-click ang Save. Ang idle screen configuration ay ipinapadala sa lahat ng nakakonektang client.

Inaasahang Resulta

Ang mga client PC na wala sa aktibong session ay nagpapakita ng slideshow na may mga na-configure na transition, clock overlay, at pangalan ng cafe. Patuloy na nag-loop ang slideshow.

Mga Karaniwang Mali

  • Pagdaragdag ng napakaraming high-resolution na larawan nang hindi isinasaalang-alang ang oras ng sync. Ang bawat media file ay kailangang ilipat sa bawat client. Panatilihing makatuwiran ang kabuuang laki ng slideshow.
  • Pagtatakda ng duration na masyadong maikli (wala pang 3 segundo). Ang mabilis na mga transition ay maaaring makaramdam ng kakaiba at nagpapahirap sa pagbabasa ng anumang teksto sa mga slide.
  • Hindi pag-test ng kulay ng orasan laban sa lahat ng slideshow na larawan. Ang isang puting orasan ay hindi nakikita sa isang maliwanag na puting slide. Pumili ng kulay na gumagana sa buong set ng iyong slideshow.

Paano Gumawa ng Anunsyo

Ang mga anunsyo ay lilitaw sa mga client desktop at maaaring mag-promote ng mga event, magbahagi ng balita, o magpakita ng mga advertisement. Awtomatikong tina-track ng system ang mga impression at click.

Kakailanganin Mo

  • HandyCafe Server na tumatakbo na may hindi bababa sa isang nakakonektang client.
  • Isang banner image (inirerekomendang 1200x400 pixels o mas malawak) kung gusto mo ng visual na anunsyo.

Mga Hakbang

  1. Pumunta sa Settings > Clients > Content tab.
  2. Mag-scroll pababa sa Announcements na seksyon sa ibaba ng mga app category.
  3. I-click ang Add Announcement.
  4. Maglagay ng Title at Text para sa anunsyo. Kung nag-li-link sa isang external na pahina, ilagay ang Link URL.
  5. Itakda ang Type na field. Piliin ang Announcement para sa pangkalahatang balita, Event para sa mga time-limited na promosyon na may interactive na form field, o Text para sa simpleng text-only na mensahe.
  6. Itakda ang Category para i-classify ang anunsyo: Link, Game, Announcement, o Ad. Tinutukoy nito kung saan ito lilitaw sa layout ng client.
  7. Mag-upload ng Banner Image sa pamamagitan ng pag-click sa image area at pagpili ng file. Ang banner ay ipinapakita sa announcement bar sa client desktop. I-click ang Save.

Inaasahang Resulta

Ang anunsyo ay lilitaw sa mga nakakonektang client desktop sa announcement bar. Habang tinitingnan at ginagamit ito ng mga customer, ina-track ng server ang Impression Count (kung ilang beses itong ipinakita) at Click Count (kung ilang beses ito na-click ng isang customer).

Mga Karaniwang Mali

  • Paggawa ng mga anunsyo nang walang banner image. Ang mga text-only na anunsyo nang walang larawan ay madaling mapansin ng mga customer sa announcement bar.
  • Pagkalimot na magtakda ng expiry o mag-alis ng mga lumang anunsyo. Ang mga lumang promosyon na nananatiling aktibo ay lumilikha ng masamang karanasan para sa customer.
  • Paggamit ng napakahabang teksto sa katawan ng anunsyo. Ang display area ay compact. Panatilihing maikli ang teksto at ilagay ang mga detalye sa likod ng link.