Hai mai trovato il tema WordPress perfetto per il tuo sito, ma con quei piccoli dettagli che proprio non ti convincono? Quel colore del pulsante sbagliato, quel font che non rispecchia il tuo brand, quel layout che vorresti leggermente diverso?

Fino a pochi anni fa, modificare un tema WordPress significava scegliere tra due opzioni poco attraenti:

1. Modificare il tema direttamente → Aggiornamenti = perdita di tutte le modifiche
2. Assumere uno sviluppatore → Costi elevati (€500-2000) e tempi lunghi

Oggi, grazie all'intelligenza artificiale e ai child theme, puoi personalizzare qualsiasi tema WordPress in modo sicuro, reversibile e professionale. E la parte migliore? Non serve essere un esperto di coding.

Cosa Troverai in Questa Guida

Questa guida pratica di oltre 2000 parole ti accompagnerà dalla creazione del tuo primo child theme fino alla personalizzazione avanzata. Ogni capitolo include:

• Spiegazioni chiare con esempi visivi
• Prompt AI pronti da copiare e incollare
• Codice CSS e PHP completo e commentato
• Checklist operative
• Tabelle comparative
• Best practice e avvertenze

Cosa Imparerai

1. Fondamenti - Cos'è child theme, architettura, vantaggi
2. Setup - Creazione, installazione, attivazione
3. Colori - Palette personalizzata con AI
4. Font - Google Fonts e tipografia responsive
5. Layout - Template override e customizzazioni
6. Funzionalità - functions.php avanzato
7. Performance - Ottimizzazione velocità
8. Testing - Checklist pre-lancio

Perché Usare un Child Theme

Statistiche Chiave

• 📊 94% dei temi WordPress riceve aggiornamenti mensili
• ⚠️ 67% utenti perde customizzazioni dopo aggiornamenti (senza child theme)
• 💰 €500-2000 costo medio customizzazione da developer
• ⏱️ 30 minuti tempo medio per child theme con AI

Capitolo 1: Fondamenti Child Theme

Cos'è un Child Theme

Un child theme è un tema WordPress che eredita tutte le funzionalità e lo stile di un tema parent, permettendoti di modificare o aggiungere funzionalità senza alterare il tema originale.

Analogia semplice: Il tema parent è una casa già costruita. Il child theme è come aggiungere vernice, mobili e decorazioni senza toccare la struttura portante.

Come Funziona l'Ereditarietà

WordPress carica i file in questo ordine:

1. Cerca il file nel child theme
2. Se non esiste, usa il file del parent theme
3. Il child theme può override qualsiasi file del parent

Esempio:

Se modifichi header.php nel child theme:
WordPress usa → child-theme/header.php
Ignora → parent-theme/header.php

Quando Usare un Child Theme

Struttura Minimale

Un child theme richiede solo DUE file:

my-child-theme/
├── style.css # Obbligatorio: header + CSS custom
└── functions.php # Opzionale ma consigliato

Struttura Completa:

my-child-theme/
├── style.css # Header tema + CSS personalizzato
├── functions.php # Funzioni custom, enqueue scripts
├── screenshot.png # Anteprima (1200x900px)
├── templates/ # Override template
│ ├── header.php
│ ├── footer.php
│ └── page-landing.php
└── assets/ # Risorse custom
├── css/
└── js/

Il File style.css: Header Obbligatorio

Ogni child theme DEVE iniziare con un header CSS commentato:

/*
Theme Name: Mio Child Theme
Theme URI: https://miosito.it/mio-child-theme
Description: Child theme del tema Twenty Twenty-Four personalizzato per il mio brand aziendale
Author: Il Tuo Nome
Author URI: https://miosito.it
Template: twentytwentyfour
Version: 1.0.0
License: GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: mio-child-theme
Tags: custom-colors, custom-fonts, responsive-layout
*/

/* Il campo "Template" è CRUCIALE: deve corrispondere ESATTAMENTE al nome della cartella del tema parent */

Spiegazione Campi Header:

⚠️ ATTENZIONE: Il campo Template deve corrispondere ESATTAMENTE al nome della cartella del tema parent. Se il parent è in /wp-content/themes/twentytwentyfour/, allora Template: twentytwentyfour.

Il File functions.php

A differenza del parent, il functions.php del child theme viene caricato PRIMA di quello del parent.

Funzioni Base:

<!--?php 
/**
 * Mio Child Theme - Functions
 */

// Security: Prevent direct access
if (!defined('ABSPATH')) {
    exit;
}

/**
 * Enqueue parent and child theme stylesheets
 */
function mio_child_enqueue_styles() {
    // Carica stylesheet del tema parent
    wp_enqueue_style(
        'parent-style',
        get_template_directory_uri() . '/style.css'
    );

    // Carica stylesheet del child theme (dopo il parent)
    wp_enqueue_style(
        'child-style',
        get_stylesheet_directory_uri() . '/style.css',
        array('parent-style'),
        wp_get_theme()->get('Version')<br ?--> );
}
add_action('wp_enqueue_scripts', 'mio_child_enqueue_styles');

/**
* Aggiungi supporto funzionalità extra
*/
function mio_child_theme_setup() {
// Supporto per logo custom
add_theme_support('custom-logo', [
'height' => 200,
'width' => 400,
'flex-height' => true,
'flex-width' => true
]);

// Supporto featured images
add_theme_support('post-thumbnails');
}
add_action('after_setup_theme', 'mio_child_theme_setup', 20);

Capitolo 2: Setup Child Theme

Prerequisiti

Prima di iniziare, assicurati di avere:

• ✅ WordPress installato (locale o remoto)
• ✅ Tema parent installato e attivo
• ✅ Accesso FTP/SFTP o file manager
• ✅ Editor di testo (VS Code, Sublime Text)
• ✅ Browser con DevTools (Chrome, Firefox)

Step-by-Step: Creazione Child Theme

Step 1: Crea la Cartella

# Locale
mkdir -p ~/Documenti/www/wp-content/themes/mio-child-theme

# Oppure via FTP nel server
cd /wp-content/themes/
mkdir mio-child-theme

Step 2: Crea style.css

/*
Theme Name: Mio Child Theme
Template: twentytwentyfour
Version: 1.0.0
*/

Step 3: Crea functions.php

<!--?php 
function mio_child_enqueue_styles() {
    wp_enqueue_style('parent-style', get_template_directory_uri() . '/style.css');
    wp_enqueue_style('child-style', get_stylesheet_uri(), array('parent-style'));
}
add_action('wp_enqueue_scripts', 'mio_child_enqueue_styles');

Step 4: (Opzionale) Crea screenshot.png

• Immagine 1200x900px
• Rappresenta il tuo tema
• WordPress la mostra nella dashboard

Step 5: Comprimi in ZIP

zip -r mio-child-theme.zip mio-child-theme/

Installazione WordPress

Metodo 1: Upload Dashboard (Consigliato)

1. Vai su WordPress Admin → Aspetto → Temi
2. Clicca "Aggiungi nuovo" → "Carica tema"
3. Seleziona il file ZIP
4. Clicca "Installa ora"
5. Clicca "Attiva"

Metodo 2: FTP/SFTP

1. Connettiti via FTP (FileZilla)
2. Naviga in /wp-content/themes/
3. Carica cartella mio-child-theme
4. Attiva da WordPress Admin → Aspetto → Temi

Metodo 3: WP-CLI

# Accedi server SSH
ssh user@yourserver.com

# Installa e attiva
cd /var/www/html/wp-content/themes
wp theme activate mio-child-theme

Verifica Installazione

Dopo attivazione, verifica:

1. ✅ Sito appare identico al parent (nessun cambiamento visibile)
2. ✅ Entrambi stylesheet caricati (ispeziona codice sorgente)
3. ✅ Nessun errore console browser

Prompt AI per Debug:

Agisci come WordPress debugger expert.

Problema: [DESCRIVI]
Tema parent: [NOME]
Child theme: [NOME]

Codice style.css:
[INCOLLA]

Codice functions.php:
[INCOLLA]

Task: Analizza e fornisci soluzione.

Capitolo 3: Personalizzare Colori con AI

La Scienza del Prompt CSS

La qualità del CSS generato dipende dalla precisione del prompt.

Sii specifico su:

• Colori esatti (codici HEX o RGB)
• Elementi target (classi, ID, tag)
• Stati (hover, focus, active)
• Responsive behavior

Prompt per Palette Colori

Prompt Base:

Agisci come CSS expert WordPress.

Task: CSS per cambiare palette:
- Primary: #2563EB (blu)
- Secondary: #10B981 (verde)
- Accent: #F59E0B (arancione)

Elementi: header, bottoni, link, footer.

Vincoli: CSS variables, hover states.

Output: CSS completo.

Prompt Avanzato:

Agisci come CSS expert specializzato in WordPress themes e accessibilità WCAG.

CONTESTO:
Child theme per Twenty Twenty-Four. Brand aziendale professionale.

TASK:
Genera CSS custom per palette colori:

Colori Brand:
- Primary: #2563EB (blu istituzionale)
- Secondary: #10B981 (verde successo)
- Accent: #F59E0B (arancione CTA)
- Background: #F8FAFC (grigio chiarissimo)
- Text: #1E293B (grigio scuro)

Elementi da Modificare:
1. Header (background, testo, menu)
2. Bottoni primari (normale, hover, focus, active)
3. Link (normale, hover, visited)
4. Footer (background, testo, link)
5. Bordi e separatori
6. Form input (border, focus)

REQUISITI TECNICI:
- Usa CSS variables (:root) per facilità manutenzione
- Includi stati hover, focus, active per accessibilità
- Contrasto minimo WCAG AA (4.5:1)
- Responsive: mobile, tablet, desktop
- Compatibilità browser (Chrome, Firefox, Safari, Edge)

OUTPUT:
- Codice CSS completo con commenti
- Spiegazione scelte colori
- Note accessibilità

CSS Generato (Esempio Completo)

/* ============================================
   Mio Child Theme - Custom Color Palette
   ============================================ */

:root {
    /* Brand Colors */
    --wp--custom--color--primary: #2563EB;
    --wp--custom--color--secondary: #10B981;
    --wp--custom--color--accent: #F59E0B;
    --wp--custom--color--background: #F8FAFC;
    --wp--custom--color--text: #1E293B;

    /* Derived Colors */
    --wp--custom--color--primary-hover: #1D4ED8;
    --wp--custom--color--text-muted: #64748B;
    --wp--custom--color--border: #E2E8F0;
}

/* Header */
.site-header {
    background-color: var(--wp--custom--color--background);
    border-bottom: 1px solid var(--wp--custom--color--border);
}

.site-title a,
.site-description {
    color: var(--wp--custom--color--text);
}

/* Primary Buttons */
.wp-block-button__link,
button,
input[type="button"],
input[type="submit"] {
    background-color: var(--wp--custom--color--primary);
    color: #FFFFFF;
    border: none;
    padding: 12px 24px;
    border-radius: 6px;
    font-weight: 600;
    transition: all 0.3s ease;
}

.wp-block-button__link:hover,
button:hover,
input[type="button"]:hover,
input[type="submit"]:hover {
    background-color: var(--wp--custom--color--primary-hover);
    transform: translateY(-2px);
    box-shadow: 0 4px 12px rgba(37, 99, 235, 0.3);
}

/* Links */
a {
    color: var(--wp--custom--color--primary);
    text-decoration: none;
    transition: color 0.2s ease;
}

a:hover {
    color: var(--wp--custom--color--secondary);
}

/* Footer */
.site-footer {
    background-color: var(--wp--custom--color--text);
    color: #FFFFFF;
}

.site-footer a {
    color: var(--wp--custom--color--accent);
}

/* Accessibility: Focus States */
a:focus,
button:focus,
input:focus {
    outline: 2px solid var(--wp--custom--color--accent);
    outline-offset: 2px;
}

Strumenti AI per Palette Colori

Prompt per ColorBot:

Genera palette per sito:
- Settore: consulenza finanziaria
- Target: professionisti 30-50 anni
- Mood: affidabile, serio, professionale
- Colori da evitare: rosso, neon

Output: 5 colori HEX con utilizzo (primary, secondary, accent, background, text).

Capitolo 4: Cambiare Font con Google Fonts

Prompt per Tipografia

Agisci come typography expert web design.

TASK:
Implementa Google Fonts:

Font Scelti:
- Heading: "Playfair Display" (serif, elegante)
- Body: "Inter" (sans-serif, leggibile)
- Accent: "JetBrains Mono" (monospace, codice)

Dimensioni Desktop:
- H1: 700, 48px
- H2: 600, 36px
- H3: 600, 24px
- Body: 400, 18px
- Small: 400, 14px

Dimensioni Mobile:
- H1: 36px
- H2: 28px
- Body: 16px

Line Height:
- Headings: 1.2
- Body: 1.7

REQUISITI:
- @import Google Fonts
- font-display: swap per performance
- Responsive media queries
- Gerarchia visiva chiara

OUTPUT: CSS completo pronto per style.css.

CSS Generato

/* ============================================
   Mio Child Theme - Custom Typography
   ============================================ */

/* Import Google Fonts */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500&family=Playfair+Display:wght@600;700&display=swap');

:root {
    /* Font Families */
    --wp--custom--font--heading: 'Playfair Display', Georgia, serif;
    --wp--custom--font--body: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
    --wp--custom--font--mono: 'JetBrains Mono', 'Fira Code', monospace;

    /* Font Sizes Desktop */
    --wp--custom--font-size--h1: 48px;
    --wp--custom--font-size--h2: 36px;
    --wp--custom--font-size--h3: 24px;
    --wp--custom--font-size--body: 18px;

    /* Line Heights */
    --wp--custom--line-height--heading: 1.2;
    --wp--custom--line-height--body: 1.7;
}

/* Apply Fonts */
body {
    font-family: var(--wp--custom--font--body);
    font-size: var(--wp--custom--font-size--body);
    line-height: var(--wp--custom--line-height--body);
}

/* Headings */
h1, h2, h3, h4, h5, h6 {
    font-family: var(--wp--custom--font--heading);
    line-height: var(--wp--custom--line-height--heading);
    font-weight: 700;
}

h1 { font-size: var(--wp--custom--font-size--h1); }
h2 { font-size: var(--wp--custom--font-size--h2); }
h3 { font-size: var(--wp--custom--font-size--h3); }

/* Code Blocks */
code, pre {
    font-family: var(--wp--custom--font--mono);
    font-size: 0.9em;
}

/* Responsive */
@media (max-width: 768px) {
    :root {
        --wp--custom--font-size--h1: 36px;
        --wp--custom--font-size--h2: 28px;
        --wp--custom--font-size--body: 16px;
    }
}

Capitolo 5: Modificare Layout e Template

Override Template

WordPress segue gerarchia template precisa. Per modificare una parte specifica, crea file con stesso nome nel child theme.

Template Principali:

Prompt per Template Custom

Agisci come web designer landing page expert.

CONTESTO:
Landing page per corso online.

TASK:
Crea page-landing.php con:
1. Hero section (titolo, sottotitolo, CTA)
2. Benefici (3 colonne icone)
3. "Cosa impari" (lista)
4. Testimonianze (carousel)
5. Pricing table (3 tier)
6. FAQ accordion
7. CTA finale

REQUISITI:
- Full-width, no sidebar
- Responsive mobile-first
- Ottimizzato conversion
- Compatibile Gutenberg

OUTPUT: Template PHP + CSS + JS.

Capitolo 6: Ottimizzazione Performance

Best Practice

Lazy Loading

// Lazy loading immagini
function child_lazy_images($attr) {
    $attr['loading'] = 'lazy';
    return $attr;
}
add_filter('wp_get_attachment_image_attributes', 'child_lazy_images');

// Lazy loading iframe
function child_lazy_iframes($html) {
    return str_replace('<iframe', '<iframe loading="lazy"', $html);
}
add_filter('wp_oembed_result', 'child_lazy_iframes');

Ottimizzare Google Fonts

// Preconnect Google Fonts
function child_preconnect_fonts($urls, $relation_type) {
    if ('preconnect' === $relation_type) {
        $urls[] = array(
            'href' => 'https://fonts.gstatic.com',<br ?--> 'crossorigin' => 'anonymous',
);
}
return $urls;
}
add_filter('wp_resource_hints', 'child_preconnect_fonts', 10, 2);

Capitolo 7: Testing Pre-Lancio

Checklist Completa

• [ ] Responsive (mobile, tablet, desktop)
• [ ] Browser (Chrome, Firefox, Safari, Edge)
• [ ] PageSpeed Insights score > 80
• [ ] Accessibilità WCAG 2.1 AA
• [ ] SEO (meta tags, structured data)
• [ ] Compatibility plugin principali
• [ ] Aggiorna tema parent e verifica

Strumenti Testing

Conclusione

Hai completato una guida completa per child theme WordPress con AI.

Riepilogo Chiave

1. Child theme essenziali per customizzazioni sicure
2. AI accelera sviluppo ma valida sempre
3. Prompt specifici = codice migliore
4. Performance matters
5. Testa prima di produzione

Prossimi Passi

• 🎨 Crea il tuo primo child theme
• 📚 Studia temi popolari su GitHub
• 🤝 Unisciti community WordPress
• 💼 Offri servizi customizzazione

Happy theming! 🎨

Scopri come sviluppare plugin WordPress professionali utilizzando l'intelligenza artificiale. Guida pratica completa con oltre 50 prompt pronti all'uso, esempi di codice dettagliati, security check e pubblicazione su WordPress.org.

Introduzione

Lo sviluppo di plugin WordPress è sempre stato considerato un territorio riservato a sviluppatori esperti con anni di esperienza in PHP, MySQL e architettura software. Oggi, grazie all'intelligenza artificiale generativa, questo panorama è radicalmente cambiato.

Che tu sia un imprenditore digitale, un content creator, un piccolo business owner o semplicemente un appassionato di WordPress, puoi ora creare plugin personalizzati per il tuo sito senza scrivere una singola riga di codice.

Cosa Troverai in Questa Guida

Questa è una guida pratica e operativa che ti accompagnerà dall'idea iniziale fino alla pubblicazione del tuo primo plugin WordPress. Ogni capitolo include:

• Spiegazioni chiare e concise
• Esempi di codice completi e commentati
• Prompt AI pronti da copiare e incollare
• Checklist operative
• Tabelle riassuntive
• Best practice e avvertenze di sicurezza

Cosa Imparerai

1. Fondamenti - Architettura plugin, hook system, action e filter
2. Prompt Engineering - Come chiedere all'AI esattamente ciò che ti serve
3. Sicurezza - Validazione, sanitizzazione, protection da attacchi comuni
4. Ambiente Sviluppo - Docker, testing locale, debugging
5. Pubblicazione - WordPress.org requirements, submission process
6. Monetizzazione - Freemium, premium, servizi correlati

Perché Usare l'AI per Sviluppare Plugin

L'intelligenza artificiale non sostituisce lo sviluppatore professionista, ma potenzia enormemente le tue capacità. Ecco i vantaggi concreti:

Statistiche WordPress 2026

• 📊 WordPress alimenta il 43% di tutti i siti web (800+ milioni)
• 📦 Oltre 60.000 plugin gratuiti su WordPress.org
• 💰 Mercato plugin premium: $2+ miliardi annui
• ⏱️ Tempo sviluppo medio: 40-80 ore (riducibili a 8-15 con AI)
• 🚀 Crescita annuale nuovi plugin: +15%

Capitolo 1: Fondamenti dei Plugin WordPress

Cos'è Esattamente un Plugin WordPress

Un plugin WordPress è un pacchetto software che aggiunge funzionalità specifiche al tuo sito, estendendo le capacità del core senza modificarne il codice sorgente.

Analogia semplice: WordPress è come uno smartphone. Il core è il sistema operativo (iOS/Android). I plugin sono le app che installi per aggiungere funzionalità (WhatsApp, Instagram, Spotify).

Perché WordPress Usa i Plugin

La filosofia WordPress è "core minimale, estensioni modulari":

• Il core fornisce funzionalità essenziali (pubblicazione contenuti, gestione utenti, sistema template)
• I plugin aggiungono tutto il resto (e-commerce, SEO, form, backup, analytics)

Questo approccio ha enormi vantaggi:

1. Mantenibilità - Il core rimane leggero e facile da aggiornare
2. Flessibilità - Ogni sito può avere esattamente le funzionalità che gli servono
3. Sicurezza - Puoi disattivare plugin non necessari
4. Ecosistema - Community enorme di sviluppatori

Architettura Standard di un Plugin

Ogni plugin ben strutturato segue convenzioni di directory e file:

Struttura Base (Plugin Semplice):

my-custom-plugin/
├── my-custom-plugin.php      # File principale (obbligatorio)
├── readme.txt                # Documentazione
├── uninstall.php             # Cleanup disinstallazione
└── languages/                # Traduzioni
    └── my-plugin-it_IT.mo

Struttura Avanzata (Plugin Complesso):

my-custom-plugin/
├── my-custom-plugin.php      # Bootstrap e header
├── readme.txt                # Documentazione completa
├── uninstall.php             # Script disinstallazione
├── includes/                 # Logica PHP
│   ├── class-plugin-core.php
│   ├── class-admin-panel.php
│   ├── class-frontend.php
│   └── class-database.php
├── assets/                   # Risorse statiche
│   ├── css/admin.css
│   ├── css/frontend.css
│   ├── js/admin.js
│   └── js/frontend.js
├── templates/                # Template personalizzabili
│   ├── single-custom.php
│   └── archive-custom.php
└── languages/                # Traduzioni
    ├── my-plugin.pot
    └── my-plugin-it_IT.mo

Il File Header: La Carta d'Identità

Ogni plugin DEVE iniziare con un header PHP commentato. WordPress legge questo header per identificare il plugin.

Esempio Completo:

<?php
/**
 * Plugin Name:         My Custom Plugin
 * Plugin URI:          https://miosito.it/my-plugin
 * Description:         Descrizione completa del plugin (max 140 caratteri)
 * Version:             1.0.0
 * Author:              Il Tuo Nome
 * Author URI:          https://miosito.it
 * License:             GPL v2 or later
 * License URI:         https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain:         my-custom-plugin
 * Domain Path:         /languages
 * Requires at least:   5.8
 * Requires PHP:        7.4
 * Tested up to:        6.5
 */

// Security: Prevent direct access
if (!defined('ABSPATH')) {
    exit;
}

Spiegazione Campi:

Hook System: Il Cuore di WordPress

WordPress funziona attraverso hook (ganci) che permettono di intercettare e modificare il comportamento del core.

Esistono DUE tipi di hook:

1. Action Hooks (Eseguono Azioni)

Le action eseguono codice in momenti specifici del ciclo di vita WordPress.

Esempio Pratico Completo:

// Invia email quando un post viene pubblicato
add_action('publish_post', 'mia_notifica_email', 10, 2);

function mia_notifica_email($ID, $post) {
    // Recupera dati
    $titolo = $post->post_title;
    $url = get_permalink($ID);
    $admin_email = get_option('admin_email');

    // Prepara email
    $oggetto = 'Nuovo Post: ' . $titolo;
    $messaggio = "Ciao Admin,\n\n";
    $messaggio .= "Nuovo post pubblicato:\n";
    $messaggio .= "Titolo: $titolo\n";
    $messaggio .= "URL: $url\n";

    // Invia
    wp_mail($admin_email, $oggetto, $messaggio);
}

Action Hook Comuni:

2. Filter Hooks (Modificano Dati)

I filter modificano dati prima che vengano salvati o visualizzati.

Esempio Pratico Completo:

// Aggiungi contenuto alla fine dei post
add_filter('the_content', 'aggiungi_firma');

function aggiungi_firma($contenuto) {
    // Solo su post singoli, non archive
    if (is_single()) {
        $contenuto .= '<div class="firma">';
        $contenuto .= '<p><strong>Ti è piaciuto? Condividi!</strong></p>';
        $contenuto .= '</div>';
    }
    return $contenuto;
}

Filter Hook Comuni:

Capitolo 2: Prompt Engineering per Plugin

La Scienza del Prompt Perfetto

La qualità del codice generato dipende DIRETTAMENTE dalla qualità del tuo prompt.

Regola d'oro: Prompt vago = codice vago. Prompt specifico = codice specifico.

Formula PECTF

P = Persona (chi deve essere l'AI)
E = Contesto (situazione, background)
C = Compito (cosa deve fare)
T = Vincoli (regole, standard)
F = Formato (come presentare output)

Prompt per Struttura Plugin

Prompt Base:

Agisci come sviluppatore WordPress senior.

Contesto: Plugin prenotazioni appuntamenti.

Task: Genera struttura cartelle e file.

Vincoli:
- WordPress Coding Standards
- Namespace PSR-4
- Separazione admin/frontend

Output: Tree directory + spiegazione.

Prompt Avanzato (Consigliato):

Agisci come Lead Developer WordPress con 10+ anni esperienza e plugin con 10.000+ installazioni attive.

CONTESTO:
Plugin SaaS freemium per prenotazioni professionisti (medici, avvocati).
Deve essere stabile, sicuro, performante, GDPR compliant.

REQUISITI:
1. Frontend: calendario, form, email conferma, reminder
2. Backend: dashboard, gestione prenotazioni, impostazioni, export
3. Database: tabelle custom, indici, cleanup automatico
4. Sicurezza: nonce, capability, prepared statements, rate limiting

TASK:
Genera struttura completa cartelle e file.

STANDARD:
- WordPress Coding Standards 3.0
- PHP 7.4+ compatibile
- Namespace PSR-4
- i18n ready (italiano, inglese, spagnolo)
- PHPDoc completo
- Hook personalizzati

OUTPUT:
1. Tree directory completo
2. Spiegazione ogni file (scopo, 2-3 righe)
3. Codice file principale con header, costanti, hook activation/deactivation
4. Esempio classe core con singleton pattern

FORMATO:
- Markdown con syntax highlighting
- Commenti in italiano
- Esempi utilizzo hook
- Note best practice sicurezza

Prompt per Funzioni Database

Agisci come esperto sicurezza WordPress e ottimizzazione database.

CONTESTO:
Funzione salvataggio prenotazioni plugin.

TASK:
Scrivi funzione PHP che:

1. VALIDAZIONE:
   - Campi obbligatori (nome, email, telefono, data, ora)
   - Formato email (is_email)
   - Formato telefono (regex italiana)
   - Data (non passato, max 90 giorni)
   - Ora (entro orari lavorativi)

2. SICUREZZA:
   - Sanitizzazione input
   - Prepared statements
   - Nonce verification
   - Capability check

3. LOGICA:
   - Controllo duplicati (stessa data/ora)
   - Controllo disponibilità
   - ID univoco
   - Salvataggio tabella custom

4. ERRORI:
   - WP_Error per ogni errore
   - Messaggi localizzati
   - Logging debug mode

5. POST-SALVATAGGIO:
   - Action hook personalizzato
   - Email conferma
   - Cleanup cache

OUTPUT:
- Codice completo commentato riga-per-riga
- Esempio chiamata funzione
- Esempio gestione errore
- Spiegazione scelte sicurezza

Prompt per Code Review

Agisci come security auditor WordPress specializzato.

TASK:
Analizza questo codice e identifica:
1. Vulnerabilità (SQL injection, XSS, CSRF)
2. Violazioni WordPress Coding Standards
3. Funzioni deprecated
4. Bug logici
5. Problemi performance

CODICE:
[INCOLLA CODICE]

OUTPUT:
- Lista problemi con gravità (Critico/Alto/Medio/Basso)
- Riga codice problematica
- Codice corretto suggerito
- Spiegazione fix

Capitolo 3: Sicurezza e Validazione

Perché Validare il Codice AI

L'AI è potente ma NON infallibile. Può generare:

• ❌ Codice obsoleto (funzioni deprecated)
• ❌ Vulnerabilità non intenzionali
• ❌ Logica errata o incompleta
• ❌ Violazioni standards WordPress

Checklist Sicurezza Completa

Input Sanitization:

• [ ] sanitize_text_field() per testo semplice
• [ ] sanitize_email() per email
• [ ] sanitize_textarea_field() per textarea
• [ ] absint() per interi positivi
• [ ] sanitize_key() per slug/chiavi

Output Escaping:

• [ ] esc_html() per contenuto HTML
• [ ] esc_url() per URL
• [ ] esc_attr() per attributi HTML
• [ ] esc_js() per JavaScript
• [ ] wp_kses() per HTML con tag permessi

Database:

• [ ] $wpdb->prepare() per tutte le query
• [ ] Placeholder %s per stringhe
• [ ] Placeholder %d per interi
• [ ] Placeholder %f per float

Form e AJAX:

• [ ] wp_nonce_field() nei form
• [ ] check_admin_referer() o wp_verify_nonce() nella validazione
• [ ] current_user_can() per capability

Accesso Diretto:

• [ ] defined('ABSPATH') in ogni file PHP

Strumenti di Validazione

Capitolo 4: Ambiente Sviluppo Docker

Perché Docker

Docker crea un ambiente isolato, riproducibile e portabile.

docker-compose.yml Completo

version: '3.8'

services:
  wordpress:
    image: wordpress:latest
    container_name: wp_dev
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wp-content:/var/www/html/wp-content
      - ./plugins/my-plugin:/var/www/html/wp-content/plugins/my-plugin
    depends_on:
      - db
    networks:
      - wp_network

  db:
    image: mariadb:10
    container_name: wp_db
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - db_data:/var/lib/mysql
    networks:
      - wp_network

  phpmyadmin:
    image: phpmyadmin:latest
    container_name: wp_phpmyadmin
    ports:
      - "8081:80"
    environment:
      PMA_HOST: db
    depends_on:
      - db
    networks:
      - wp_network

volumes:
  db_data:

networks:
  wp_network:

Comandi Essenziali

# Avvia
docker compose up -d

# Ferma
docker compose down

# Log
docker compose logs -f wordpress

# Accedi
docker compose exec wordpress bash

# WP-CLI
docker compose exec wordpress wp plugin list

Capitolo 5: Pubblicazione WordPress.org

Requisiti Obbligatori

• ✅ Codice conforme WordPress Coding Standards
• ✅ Licenza GPL-compatible
• ✅ readme.txt completo e formattato
• ✅ Nessuna chiamata HTTP esterna non opzionale
• ✅ Nessuna pubblicità o link promozionali
• ✅ Security: input sanitizzati, output escaped
• ✅ i18n ready per traduzioni

Processo di Sottomissione

1. Crea Account su wordpress.org/support/register/
2. Prepara Pacchetto ZIP (no .git, no test, no node_modules)
3. Sottometti su wordpress.org/plugins/developers/add/
4. Attendi Review (2-5 giorni lavorativi)
5. Rispondi Feedback e aggiorna se necessario

readme.txt Template

=== Plugin Name ===
Contributors: tuo-username
Tags: tag1, tag2, tag3
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

Breve descrizione (max 150 caratteri).

== Description ==

Descrizione completa.

== Installation ==

1. Carica plugin in /wp-content/plugins/
2. Attiva da menu Plugin
3. Configura impostazioni

== Changelog ==

= 1.0.0 =
* Release iniziale

Conclusione

Hai completato una guida completa per sviluppare plugin WordPress con AI.

I 10 Comandamenti

1. AI è assistente, non sostituto
2. Valida sempre il codice
3. Documenta tutto
4. Testa in ambiente isolato
5. Segui WordPress Coding Standards
6. Chiedi spiegazioni all'AI
7. Itera rapidamente
8. Usa Git per backup
9. Condividi con community
10. Divertiti!

Risorse

Buon coding! 🚀

Meta: 2100+ parole | 12 min lettura