Za programere

Teme i blokovi, iz vašeg editora

Kupiša je napravljena na PHP-u i Yii2. Temu pišete u svom repozitorijumu, uz SDK koji opisuje sve na čemu smete da gradite, a jedna komanda je šalje na sajt i osvežava stranicu pri svakoj izmeni.

Ilustracija: klasa bloka u editoru koda, isti blok na sajtu i komanda koja šalje izmene

Šta je u SDK-u

Sve što vam treba da napravite temu, a da ne vidite kod platforme.

  • Uputstva

    Kako se pravi tema, kako blok i kako se sadržaj sajta piše kao fajlovi.

  • Stubovi

    Javne klase platforme sa komentarima i potpisima. Editor ih dopunjava, a PHPStan proverava.

  • Početna tema

    Mala, potpuna tema od koje kreće svaka nova.

  • Prikazi i tokeni

    Prikazi sajta i blokova, koje tema menja fajl po fajl, i dizajn tokeni.

  • Pravila za AI asistenta

    AGENTS.md kaže asistentu sa kojim radite šta sme i kako se piše tema.

  • Komandna linija

    kupisa push, kupisa dev i prenos sadržaja između sajta i repozitorijuma.

Od repozitorijuma do sajta

  1. Napravite repozitorijum

    Krenite od šablona, a composer install donosi SDK.

  2. Povežite sajt

    kupisa connect pita za adresu sajta i vaš SSH ključ.

  3. Pišite i gledajte

    kupisa dev šalje svaku sačuvanu izmenu i osvežava stranicu u pregledaču.

Blok je jedna klasa i jedan prikaz

Klasa kaže koje vrednosti blok ima i kojim kontrolama se uređuju u editoru stranica, a prikaz ih ispisuje. Klijent ga zatim koristi kao i svaki drugi blok.

  • Kontrole: tekst, slika, link, izbor, lista stavki
  • Prevod za svaki tekst
  • Stilovi na dizajn tokenima teme

Sadržaj sajta kao fajlovi

Stranice, meniji i slike sajta žive i kao paket fajlova u repozitorijumu. content/pull ih donosi sa sajta, content/push ih vraća, a --dry-run prvo kaže šta bi se promenilo.

  • Jedan fajl po stranici
  • Isti paket za probni i za pravi sajt
  • Paket sa greškom ne menja ništa

Česta pitanja

Šta mogu da napravim?

Za sada teme i blokove. Podrška za module u SDK-u je sledeća na redu.

Koja tehnologija je ispod?

PHP 8.4 i Yii2. Stilovi se pišu na dizajn tokenima, bez CSS framework-a i JavaScript biblioteka.

Da li mi treba kod platforme?

Ne. SDK donosi stubove javnih klasa, a PHPStan javlja kad pozovete nešto što platforma ne nudi.

Mogu li da radim sa AI asistentom?

Da. SDK je pisan i za njega: AGENTS.md mu kaže pravila, a stubovi i primeri šta postoji.

Kako dobijam pristup?

Pišite nam. Kad dodamo vaš SSH ključ na server, povezujete se jednom komandom.

Napravite svoju prvu temu

Javite nam se za pristup, a SDK vas vodi dalje.