dashdanilo/soundit

📦

Warehouse

WordPress starter theme baseado no Sage 10

Documentação Sage 9

Features

• SCSS
• ES6
• Laravel Mix para compilar assets e concatenating e minificar ficheiros
• Browsersync para browser testing sincronizado
• Blade como template engine
• Sage Directives Blade Directives para WordPress, ACF e utilidades
• Clean Up de várias features do WordPress

Libs incluídas

• Normalize CSS para reset dos estilos
• Foundation for Sites
• Locomotive Scroll para Smooth Scroll
• Highway JS para transição de páginas em PJAX
• GSAP para animações em JS
• GSAP Bonus Plugins (Todos)

Requisitos

• WordPress >= 5.4
• PHP >= 7.2.0 (with php-mbstring enabled)
• Composer
• Node.js >= 8.0.0
• Yarn

Estrutura do tema

themes/your-theme-name/   # → Root of your Sage based theme
├── app/                  # → Theme PHP
│   ├── Composers/        # → View composers
│   ├── Providers/        # → Service providers
│   ├── admin.php         # → Theme customizer setup
│   ├── filters.php       # → Theme filters
│   ├── helpers.php       # → Helper functions
│   └── setup.php         # → Theme setup
├── config/               # → Config files
│   ├── app.php           # → Application configuration
│   ├── assets.php        # → Asset configuration
│   ├── filesystems.php   # → Filesystems configuration
│   └── view.php          # → View configuration
├── composer.json         # → Autoloading for `app/` files
├── composer.lock         # → Composer lock file (never edit)
├── dist/                 # → Built theme assets (never edit)
├── functions.php         # → Composer autoloader, Acorn bootloader
├── index.php             # → Never manually edit
├── node_modules/         # → Node.js packages (never edit)
├── package.json          # → Node.js dependencies and scripts
├── resources/            # → Theme assets and templates
│   ├── assets/           # → Front-end assets
│   │   ├── fonts/        # → Theme fonts
│   │   ├── images/       # → Theme images
│   │   ├── scripts/      # → Theme JS
│   │   └── styles/       # → Theme stylesheets
│   └── views/            # → Theme templates
│       ├── components/   # → Component templates
│       ├── layouts/      # → Base templates
│       └── partials/     # → Partial templates
├── screenshot.png        # → Theme screenshot for WP admin
├── storage/              # → Storage location for cache (never edit)
├── style.css             # → Theme meta information
├── vendor/               # → Composer packages (never edit)
└── webpack.mix.js        # → Laravel Mix configuration

Setup

Editar app/setup.php para habilitar ou desabilitar features do tema, como menus, tamanhos de thumbnail, etc.

Desenvolvimento do tema

• Correr yarn na pasta do tema para instalar dependências
• Atualizar webpack.mix.js com o URL de desenvolvimento local (ex: warehouse.test)

Build commands

• yarn start — Compila assets quando são feitas atualizações nos ficheiros e começa uma sessão do Browsersync
• yarn build — Compila e optimiza os ficheiros na pasta assets
• yarn build:production — Compila os assets para produção

Documentação Sage

• Sage 9 (a ser atualizado para a v10)