Skip to content

Oltrematica/oltreblocksy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OltreBlocksy WordPress Theme

Un tema WordPress altamente modulare e configurabile che supera Blocksy in termini di opzioni, bellezza, pulizia, modularitΓ  e performance.

πŸš€ Caratteristiche Principali

Architettura Modulare Avanzata

  • Sistema modulare completo: Ogni funzionalitΓ  Γ¨ un modulo separato che puΓ² essere attivato/disattivato
  • Autoloader PSR-4: Namespace e autoloading per tutte le classi
  • API estendibile: Hooks e filters per personalizzazioni avanzate

Sistema Tipografico Rivoluzionario

  • Typography fluida: Scaling automatico basato su viewport con clamp()
  • Font pairing intelligente: Combinazioni tipografiche pre-configurate
  • Preset tipografici: Elegant, Modern, Editorial, Minimalist, Creative
  • Google Fonts ottimizzati: Caricamento intelligente con preconnect

Performance di Prima Classe

  • Critical CSS inline: CSS critico generato dinamicamente
  • Lazy loading avanzato: Immagini, iframe, video e componenti
  • Code splitting: JavaScript modulare con caricamento condizionale
  • Resource hints: Preload, prefetch, preconnect intelligenti
  • Ottimizzazioni database: Cache delle query e object caching

Sistema Colori Avanzato

  • Design tokens centralizzati: Sistema di token per colori, spaziature, tipografia
  • Palette dinamiche: Generazione automatica di palette colori complementari
  • Dark mode intelligente: Switch automatico basato su preferenze sistema
  • Accessibility checker: Controllo automatico contrasto WCAG 2.1 AA

Layout System CSS Grid Nativo

  • CSS Grid moderno: Layout system basato su CSS Grid con fallback Flexbox
  • Container queries: Supporto per container queries quando disponibili
  • Aspect ratio control: Controllo completo delle proporzioni
  • Spacing system: Sistema di spaziature coerente

Customizer API Esteso

  • Pannelli dinamici: Sistema di pannelli che si adattano al contenuto
  • Controlli personalizzati: Slider, color picker, typography selector
  • Conditional logic: Opzioni che appaiono/scompaiono basate su altre selezioni
  • Live preview: Anteprima in tempo reale di tutte le modifiche

AccessibilitΓ  WCAG 2.1 AA

  • Compliance completa: Supporto screen reader e navigazione tastiera
  • Focus management: Gestione avanzata del focus per modali e menu
  • Skip links: Collegamenti di salto per utenti tastiera
  • ARIA labels: Markup semantico avanzato
  • Contrast checking: Controllo automatico del contrasto colori

🎯 Obiettivo

Creare il tema WordPress piΓΉ configurabile e performante disponibile, superando significativamente le capacitΓ  di Blocksy e stabilendo nuovi standard per:

  • ConfigurabilitΓ : Opzioni piΓΉ avanzate e intuitive
  • Performance: Tempi di caricamento <1.5 secondi
  • QualitΓ  del codice: Codice pulito, commentato e testabile
  • ModularitΓ : Architettura completamente modulare
  • AccessibilitΓ : Compliance WCAG 2.1 AA completa

πŸ“ Struttura File

oltreblocksy-theme/
β”œβ”€β”€ style.css                          # Stylesheet principale
β”œβ”€β”€ functions.php                      # Core del tema con autoloader
β”œβ”€β”€ index.php                         # Template principale
β”œβ”€β”€ header.php                        # Header template
β”œβ”€β”€ footer.php                        # Footer template
β”œβ”€β”€ theme.json                        # Configurazione avanzata FSE
β”œβ”€β”€ inc/                              # Classi e moduli PHP
β”‚   β”œβ”€β”€ helpers.php                   # Funzioni di utilitΓ 
β”‚   β”œβ”€β”€ template-functions.php        # Funzioni template
β”‚   β”œβ”€β”€ template-tags.php            # Tag template personalizzati
β”‚   └── Modules/                     # Sistema modulare
β”‚       β”œβ”€β”€ Base_Module.php          # Classe base moduli
β”‚       β”œβ”€β”€ Performance.php          # Ottimizzazioni performance
β”‚       β”œβ”€β”€ Typography.php           # Sistema tipografico
β”‚       β”œβ”€β”€ ColorSystem.php          # Sistema colori avanzato
β”‚       β”œβ”€β”€ Customizer.php           # Customizer esteso
β”‚       └── Accessibility.php        # FunzionalitΓ  accessibilitΓ 
β”œβ”€β”€ assets/                          # Asset statici
β”‚   β”œβ”€β”€ css/                        # Stylesheets
β”‚   β”‚   └── modules/                # CSS moduli specifici
β”‚   β”œβ”€β”€ js/                         # JavaScript
β”‚   β”‚   β”œβ”€β”€ main.js                 # JavaScript principale
β”‚   β”‚   └── modules/                # JS moduli specifici
β”‚   └── images/                     # Immagini tema
β”œβ”€β”€ templates/                       # Template FSE
β”‚   β”œβ”€β”€ parts/                      # Template parts
β”‚   └── patterns/                   # Block patterns
└── languages/                      # File traduzione

⚑ Performance Metrics Target

  • PageSpeed Score: 100/100
  • Loading Time: <1.5 secondi
  • First Paint: <0.8 secondi
  • Core Web Vitals: Tutti verdi
  • Accessibility Score: 100/100

πŸ”§ Requisiti Tecnici

  • WordPress: 6.0+
  • PHP: 8.0+
  • Browsers: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+

🎨 Design Tokens

Il tema utilizza un sistema di design tokens centralizzato:

:root {
  /* Spacing System */
  --spacing-xs: clamp(0.25rem, 0.5vw, 0.5rem);
  --spacing-sm: clamp(0.5rem, 1vw, 1rem);
  --spacing-md: clamp(1rem, 2vw, 2rem);
  
  /* Typography Scale */
  --font-size-base: clamp(1rem, 1.25vw, 1.125rem);
  --font-size-lg: clamp(1.125rem, 1.4vw, 1.25rem);
  
  /* Color System */
  --color-primary: #1e40af;
  --color-text: #1e293b;
  --color-background: #f8fafc;
}

🧩 Sistema Modulare

Ogni funzionalitΓ  Γ¨ implementata come modulo separato:

// Esempio di modulo personalizzato
class Custom_Module extends Base_Module {
    protected function get_name() {
        return 'Custom';
    }
    
    protected function init() {
        // Inizializzazione modulo
    }
}

🌐 Internazionalizzazione

Il tema Γ¨ completamente tradotto e supporta:

  • Text domain: oltreblocksy
  • Tutte le stringhe sono wrapped con funzioni di traduzione
  • File POT incluso per traduzioni

πŸ“± Responsive Design

  • Mobile-first approach
  • Breakpoints personalizzabili
  • Container queries support
  • Fluid typography e spacing

πŸ”’ Sicurezza

  • Sanitizzazione completa di tutti gli input
  • Escape di tutti gli output
  • Nonce verification per AJAX
  • Capability checks per admin

πŸ§ͺ Testing

Il tema include:

  • PHPUnit tests per logica PHP
  • JavaScript tests per funzionalitΓ  JS
  • Accessibility tests automatizzati
  • Performance benchmarks

πŸ“š Documentazione

Documentazione completa disponibile per:

  • Sviluppatori: Hook, filter, API
  • Designer: Customizer, design tokens
  • Utenti finali: Configurazione, utilizzo

🀝 Contributi

Contributi benvenuti! Per favore:

  1. Fork del repository
  2. Crea feature branch
  3. Commit delle modifiche
  4. Push al branch
  5. Crea Pull Request

πŸ“„ Licenza

GPL v2 or later

πŸ†š Confronto con Blocksy

Caratteristica OltreBlocksy Blocksy
Moduli βœ… Sistema completamente modulare ❌ Monolitico
Performance βœ… <1.5s loading ❌ ~2-3s loading
Typography βœ… Sistema rivoluzionario ❌ Opzioni base
AccessibilitΓ  βœ… WCAG 2.1 AA completo ❌ Parziale
Color System βœ… Avanzato con AI ❌ Basic
Code Quality βœ… PSR-4, OOP ❌ Procedural
Customizer βœ… Controlli avanzati ❌ Standard
SEO βœ… Schema markup avanzato ❌ Basic

OltreBlocksy - Beyond Blocksy, Beyond Limits πŸš€

About

Free Wordpress theme to help you build your next web project visually in minutes, without coding skills.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published