View Categories

Getting Started – Punkode Framework

1 min read

Il Punkode Framework è la base tecnica comune che alimenta progetti come Diventi, D20, plugin WordPress come PK Inexpress, e qualsiasi applicazione web o desktop sviluppata sotto il brand Punkode.

Questo documento ti guida nella configurazione iniziale, così puoi creare un progetto funzionante in pochi minuti.

1. Posiziona la cartella Punkode nel tuo progetto #

Struttura consigliata:

project/
    public/
        index.php
    punkode/
        setup.php
        anarkore/
        nff/

2. Carica il bootstrap #

Nel tuo public/index.php:

require __DIR__ . '/../punkode/setup.php';

Questo è sufficiente per attivare tutto il framework.

Configurazione iniziale #

Apri il file:

punkode/anarkore/anarkore-setup.php

Modifica i parametri principali:

public string $db       = "nome_database";
public string $host     = "127.0.0.1:3306";
public string $user     = "root";
public string $password = "";

Imposta anche la base URL:

public string $url_dir_main = "http://localhost/progetto/";

Da qui in poi:

  • DB_PK sa come connettersi
  • le tabelle possono essere generate
  • i form iniziano a funzionare
  • NFF sa dove salvare i file

Primo esempio funzionante #

Ecco un esempio semplicissimo per verificare che tutto funzioni:leggere dati da una tabella e mostrarli in una tabella HTML generata da Anarkore.

Esempio #

// Connessione tramite DB_PK (eredita i parametri dal setup)
$db = new DB_PK();

// Query
$rows = $db->pk_select("SELECT * FROM utenti");

// Creazione tabella HTML
$table = new TABLE_PK($rows);
echo $table->render();

Se vedi una tabella HTML generata automaticamente, allora Punkode è correttamente attivo.


Prossimi passi #

  • Approfondire il modulo Anarkore (form, input, CRUD)
  • Usare l’engine NFF per upload e resize immagini
  • Integrare Punkode in progetti WordPress tramite gli adapter
  • Creare pannelli admin personalizzati con template Bootstrap

Vedi anche: #

  • Setup e Bootstrap
  • Anarkore – DB e Form
  • NFF – Upload e Immagini
  • Esempi pratici

Cos’è Punkode Framework #

Punkode è composto da tre blocchi principali:

1. PUNKODE Boot (setup generale) #

Il file setup.php inizializza l’ambiente:

  • Carica variabili da .env
  • Riconosce se stai avviando una web app o una desktop app
  • Definisce percorsi e URL
  • Avvia automaticamente Anarkore e NoFutureFrame

È il punto di ingresso dell’intero framework.

2. Anarkore (DB + Form + Tabelle) #

Modulo pensato per creare rapidamente:

  • connessioni database (via PDO)
  • backend CRUD
  • form HTML (anche complessi)
  • tabelle amministrative in stile Bootstrap

Include classi come:

  • DB_PK
  • FORM_PK
  • TABLE_PK
  • INPUT_PK

Perfetto per applicazioni interne, gestionali e pannelli admin.

3. NFF – NoFutureFrame (Upload, File, Resize) #

Motore comune per:

  • gestire gli upload
  • normalizzare $_FILES
  • generare file sicuri (PUNK_FileAsset)
  • ridimensionare immagini
  • salvare file in ambienti diversi (WordPress, PHP/Laravel)

Gli adapter permettono al tuo codice di funzionare:

  • su WordPress
  • su PHP standalone
  • su Laravel-style
    senza cambiarlo.

Powered by BetterDocs