potterywp/potter

Set of tools that help you make WordPress sites more easily.

Monday, March 16, 2015
by vinicius73
Repository
2 Watchers
15 Stars
54 Installations

PHP
0 Dependents
0 Suggesters
3 Forks
0 Open issues
6 Versions
0 % Grown

The README.md

Potter

Conjunto de ferramentas que ajudam a criar sites WordPress mais facilmente., _(*1)

Potter ainda esta em fase beta, _(*2)

Instalação

No seu composer.json, _(*3)

    "require": {
      "potterywp/potter": "1.*"
   },

No seu functions.php, _(*4)

   require_once "vendor/autoload.php";

Características

Post/Type - Crie custom posts types com facilidade e flexibilidade
ThemeOptions - Opções de tema ficam faceis de serem criados. Potter usa um wrapper para option-tree, melhorando ainda mais o fluxo de desenvolvimento.
Features - Potter possui uma série de helpers que facilitão a inclusisão de recursos nos seus projetos com Wordpress, como a inclusão de css e javascript com facilidade em suas páginas.

Features

Para usar o Features insira o seguinte código em seu functions.php logo após require_once "vendor/autoload.php"; A vantagem de usar as funções do Features é o ganho em organização e otimização, já que em poucas linhas você tem vários recursos do WP que você teria que separar em vários arquivos para manter organizado. Potter se encarrega de carregar os comandos apenás quando eles são nescessários., _(*5)

use Potter\Potter;

$features = Potter::features();

Adcione menus ao seu tema, _(*6)

// $features->addMenu($location, $description);
$features->addMenu('main', 'Menu Principal');

Theme Support

// $features->addThemeSupport($feature, $arguments = array());
$features->addThemeSupport('post-thumbnails');
$features->addThemeSupport('post-formats');

Post Type Support

// $features->addPostTypeSupport($post_type, $feature)
$features->addPostTypeSupport('page', 'excerpt');

Image Size

// $features->addImageSize($name, $width = 0, $height = 0, $crop = false);
$features->addImageSize('thumb-home', 300, 300, true);
$features->addImageSize('thumb-page', 248, 888, true);
$features->addImageSize('thumb-contact', 460, 400, false);

Assets

Adcione e organize arquivos css e js com facilidade., _(*7)

CSS

// $features->addCss($handle, $src = false, $deps = array(), $ver = null, $media = 'all');
$features->addCss('gfonts', 'http://fonts.googleapis.com/css?family=Rosario:400,700');
$features->addCss('main', 'assets/pub/css/main.css');

JS

// $features->addJs($handle, $src, $deps = array(), $ver = null, $in_footer = false);
// $features->addJsToHead($handle, $src, $deps = array(), $ver = null);
// $features->addJsToFooter($handle, $src, $deps = array(), $ver = null);

$features->addJsToHead('modernizr', 'assets/pub/js/vendor/modernizr-2.6.2-respond-1.1.0.min.js');
$features->addJsToFooter('app', 'assets/pub/js/app.js');

jQuery CDN

Defina qual a versão de jQuery você esta usando. Potter vai ajustar todas as configurações nescessárias automaticamente., _(*8)

// $features->setJqueryCDNSupport($version, $fallback = null, $migrate = null, $in_footer = false);
$features->setJqueryCDNSupport('2.1.1', 'assets/pub/js/vendor/jquery-2.1.1.min.js', 'assets/pub/js/vendor/jquery-migrate-1.2.1.min.js');

Alem de definir a versão do jQuery que você quer, você pode definir o seu fallback (caso o cdn não carregue) e ainda definir o jQuery migrate., _(*9)

Google Analytcs

Adcione o código de rastreamento do Google Analytcs no tema com apenas uma linha de código., _(*10)

// $features->setGoogleAnalytcsID($id);
$features->setGoogleAnalytcsID('A1-XXXXXX');

Mude a imagem de login do Wordpress (d+ não?), _(*11)

// $features->setLoginLogo($logo, $style = array());
$features->setLoginLogo('assets/pub/imgs/login-logo.png', array('width'=>'150px'));

Opções do tema

Trabalhar com sites feitos em WP é muito bom, porém há momentos que precisamos deixar determinados recursos mais flexiveis pelo ambiente do usuário final (o cliente), para isso usamos recursos como o Theme Options.
Há varias formas de se implementar Theme Options, umas mais faceis e/ou robustas que outras. O plugin option-tree é uma exelente opção para se usar, é facil e flexivel, porém não possui uma interface de desenvolvimento que agrade a todos.
Por isso o Potter possui um wrapper API que facilita muito o trabalho de desenvolvimento de Theme Options com o option-tree., _(*12)

Criando seu ThemeOptions

Crie uma pasta chamada /app dentro da raiz do seu tema /wp-content/themes/meutema/
Dentro da pasta app crie um arquivo chamado ThemeOptions.php
Dentro de ThemeOptions.php coloque o seguinte código:, _(*13)

```php <?php use Potter\Theme\Options;, _(*14)

class ThemeOptions extends Options { protected $page_title = 'Opções do Tema'; protected $menu_title = 'Opções do Tema'; protected $settings_id = 'my_theme_options_id';, _(*15)

public function doRegister() { } }, _(*16)


> No momento que o Potter inicializar suas configurações ele automaticamente cria uma instancia de `ThemeOptions` então você não precisa fazer mais nada alem de criar o arquivo e colocar suas configurações lá.

### Configurações adcionais

Você ainda tem mais opções disponiveis, que te permitiram custumizar melhor seu ThemeOptions
 ```php
 class ThemeOptions extends Options
 {
    protected $page_title = 'Theme Options';
    protected $menu_title = 'Theme Options';
    protected $settings_id = 'theme_options';
    protected $header_logo = null;
    protected $header_version_text = null;
    protected $header_logo_link = null;
    protected $show_new_layout = false;
    protected $show_docs = false;
    protected $show_pages = false;
    protected $options_capability = 'edit_theme_options';

    protected $contextual_help
        = array(
            'content' => array(),
            'sidebar' => ''
        );

Adcionando opções

Todas os campos/opções são executados dentro de doRegister(), _(*17)

```php public function doRegister() { // Primeiro você cria a seção $this->addSection('general', 'Geral') // depois você adcionar as opções, que são automaticamente inseridas na devida seção ->addUpload('logo', 'Logo') ->addText('header_slogan', 'Header Slogan');, _(*18)

$this->addSection('another_section', 'Another')
    ->addTextArea('text_impact', 'Text impact')
    ->addPageSelect('my_page_id', 'Select Page');


// Você não é obrigado a encadear os metodos
$this->addSection('more_section', 'GoT');
$this->addCustomPostTypeSelect('my_got_id','Select GoT', 'Desc of select', 'got');
$this->addCategorySelect('my_cat_id','Select GoT', 'Desc of select', 'got');
// As as opções são anexadas automaticamente a última seção configurada.

}, _(*19)


#### Opções disponíveis

- **addText**   
   `$this->addText($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *text*
- **addTextarea**   
    `addTextarea($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *textarea*
- **addSelect**    
   `$this->addSelect($id, $label, array $choices, $desc = null, $std = null, $section = null, array $extra = array())` *field of type select.*
- **addCheckbox**     
    `$this->addCheckbox($id, $label, array $choices, $desc = null, $std = null, $section = null, array $extra = array())` *field of type checkbox.*
- **addRadio**  
    `$this->addRadio($id, $label, array $choices, $desc = null, $std = null, $section = null, array $extra = array())` *field of type radio.*
- **addWYSIWYG**  
    `$this->addWYSIWYG($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *WYSIWYG*
- **addUpload**  
    `$this->addUpload($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *upload (image)*
- **addCustomPostTypeSelect**  
    `$this->addCustomPostTypeSelect($id, $label, $desc = null, $postType = 'post', $std = null, $section = null, array $extra = array())` *select type field with custom post type*  
- **addCustomPostTypeCheckbox**   
    `$this->addCustomPostTypeCheckbox($id, $label, $desc = null, $postType = 'post', $std = null, $section = null, array $extra = array())` *checkbox type field with custom post type*  
- **addPageSelect**  
   `$this->addPageSelect($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *select type field with post type page*
- **addPageCheckbox**  
   `$this->addPageCheckbox($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *checkbox type field with post type page*
- **addPostCheckbox**  
   `$this->addPageCheckbox($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *checkbox type field with post type post*
- **addPostSelect**  
   `$this->addPostSelect($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *select type field with post type post*
- **addTaxonomySelect**  
   `$this->addTaxonomySelect($id, $label, $desc = null, $taxonomy = 'category', $std = null, $section = null, array $extra = array())` *select type field with taxonomy*
- **addTaxonomyCheckbox**  
   `$this->addTaxonomyCheckbox($id, $label, $desc = null, $taxonomy = 'category', $std = null, $section = null, array $extra = array())` *checkbox type field with taxonomy*
- **addCategorySelect**  
   `$this->addCategorySelect($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *select type field with categories*
- **addCategoryCheckbox**  
   `$this->addCategoryCheckbox($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *checkbox type field with categories*
- **addTagSelect**  
   `$this->addTagSelect($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *select type field with tags*
- **addTagCheckbox**  
   `$this->addTagCheckbox($id, $label, $desc = null, $std = null, $section = null, array $extra = array())` *checkbox type field with tags*
- **addTypography**  
   `$this->addTypography($id, $label, $desc = null, $std = null, $section = null, array $extra = array())`
- **addOnOff**  
   `$this->addOnOff($id, $label, $desc = null, $std = null, $section = null, array $extra = array())`
- **addOption**  
   `$this->addOption(array $args)` Raw data for option.


### Recuperando opções

Recuperar os dados salvos no ThemeOptions é muito fácil.

```php

$option_name = OPT::get('option_name', 'default_value');

OPT::_get('option_name', 'default_value'); // echo OPT::get('option_name', 'default_value');

$option = OPT::get_nl2br('option_name', 'default_value'); // $option =  nl2br(OPT::get('option_name', 'default_value'));

OPT::_get_nl2br('option_name', 'default_value') // echo nl2br(OPT::get('option_name', 'default_value'));

Post Types / Models

Não são raros os momentos onde precisamos criar custom post para atender as exigencias dos projetos.
Potter possui uma API que tem como objetivo facilitar esse trabalho, que as vezes tende a ser chato e complicado., _(*20)

A API do Potter foi feita sobre o Super-CTP, _(*21)

Criando um PostType

Crie uma pasta chamada /app/models dentro da raiz do seu tema /wp-content/themes/meutema/
Dentro da pasta /app/models você vai criar um arquivo/classe para cada post type que deseja criar, a classe deve possuir o mesmo nome que o arquivo., _(*22)

Por conversão use CamelCase para criar as classes, e para melhor identifica-lás acressente Type ou Model ao final do nome.
Ex: SliderModel.php ou SliderType.php
O Potter automaticamente criará o post type 'slider', _(*23)

SliderType.php, _(*24)

O conteúdo do arquivo deve ficar assim:, _(*25)

<?php

use Potter\Post\Type;

class SliderType extends Type
{
    protected $supports = array('title', 'thumbnail');
    protected $public = false;
    protected $show_ui = true;
    public $icon = 'picture-o';
}

Configurações disponiveis

Há ainda várias configurações disponiveis., _(*26)

<?php

use Potter\Post\Type;

class SliderType extends Type
{
    public $type = 'carrocel'; // força o post type da classe
    protected $taxonomies = array();
    protected $labels = array();
    protected $capabilities = array();
    protected $args = array();
    protected $supports = array();
    public $icon = 'dashicons-admin-post';
    protected $capability_type = 'page';
    protected $public;
    protected $show_ui;
    protected $description;
    protected $route;
    protected $queryArgs = array();

    protected $meta_boxes = array();
}

Você pode extender qualquer atributo ou método da classe Super_Custom_Post_Type.php, _(*27)

Meta-Boxes

O próprio Super-CTP possui um sistema de meta-boxes, porem ele é um pouco limitado. Potter usa o plugin meta-box que proporciona muito mais flixebilidade e opções., _(*28)

Para cadastrar uma meta-box a um post-type acressente as opções desejadas ao atributo $meta_boxex, _(*29)

protected $meta_boxes
        = array(
            'metabox-id' => array(
                'title' => 'Dados do slider',
                'fields' => array(
                    array(
                        'name' => 'link',
                        'id' => 'link',
                        'type' => 'text',
                        'clone' => false,
                    ),
                    array(
                        'name' => 'Target',
                        'id' => 'target',
                        'type' => 'select',
                        'options' => array(
                            '_new',
                            '_self',
                        )
                    )
                )
            )
        );

Todas as configurações do meta-box estão disponiveis, _(*30)

Post Type Query

O uso do WP_Query por muitas vezes é complicado, e não fornece uma API muito bonita de de trabalhar. Com o Potter fica muito fácil executar consultas., _(*31)

Instanciando a Query

No local onde deseja executar a sua consulta, você pode usar o seguinte comando., _(*32)

// Retorna um objeto WP_Query
$sliders = \Potter\Potter::model('slider')->all(); // passe como parametro o nome do model/post type que você criou

// Nada muda no seu código
if($query->have_posts()):
    while($query->have_posts()): $query->the_post()
        /// 
    endwhile;
endif;

Há varios métodos disponíveis., _(*33)

// Retorna um objeto Potter/Post/ModelQuery
$slidersQuery = \Potter\Potter::model('slider'); // passe como parametro o nome do model/post type que você criou

// Retorna um objeto WP_Query
$slidersQuery->perPage(15)->order('author')->exclude(99)->exe();

// Retorna um objeto WP_Query
$slidersQuery->perPage(15)->exe();
$slidersQuery->exe($args = array()); // Passe parametros extras diretamente para o WP_Query
$slidersQuery->get(5, $args = array()) // Uma quantidade limitada de resultados

// Retorna um objeto WP_Query
$slidersQuery->perPage(5)->byParent(9) // Páginas filhas do ID 9
$slidersQuery->perPage(5)->exclude(get_the_ID())->byParent(9) // Páginas filhas do ID 9, menos a página atual

Set of tools that help you make WordPress sites more easily.

potterywp/potter

The README.md

Potter

Instalação

Características

Features

Menu

Theme Support

Post Type Support

Image Size

Assets

CSS

JS

jQuery CDN

Google Analytcs

Login Logo

Opções do tema

Criando seu ThemeOptions

Adcionando opções

Post Types / Models

Criando um PostType

Configurações disponiveis

Meta-Boxes

Post Type Query

Instanciando a Query

The Versions

dev-master

The Requires

by Vinicius Reis

1.1.9

The Requires

by Vinicius Reis

v1.1.4

The Requires

by Vinicius Reis

v1.1.3

The Requires

by Vinicius Reis

v1.1.2

The Requires

by Vinicius Reis

1.1

The Requires

by Vinicius Reis