Como manipular dados com ACF

Manipulando dados com o ACF
WordPress Meetup Rio de Janeiro
Novembro de 2018
Foto por Max Felner

Rudá Almeida
Integrante da equipe de Tecnologia da Informação da UFRJ
Entusiasta do WordPress e integrante da comunidade carioca
Palestrante, voluntário e co-organizador de Meetups e WordCamps
Manipulando dados com o ACF
WordPress Meetup Rio de Janeiro
Novembro de 2018

Como manipular dados
usando Advanced
Custom Fields

Definição formal
“Informações descrevem um domínio
físico ou abstrato. Dado é tudo aquilo
que pode ser processado.”
Gadomski, 1993

Principais tipos de dados nativos
Tipos de publicações
● Posts
● Páginas

Principais tipos de dados nativos
● Posts
● Páginas
Tipos de metadados
● Título
● Autor
● Data e hora de publicação
● Imagem de destaque

Dados nativos no WordPress
Os tipos de dados nativos que
o WordPress oferece por
padrão podem não ser os mais
adequados para o seu projeto.

Tipo de conteúdo: Livro
● Título
● Autor
● Data de lançamento
● Imagem da capa
● Editora
● Tema
● Quantidade de páginas
● Peso
● Dimensões
● Arquivo de e-book

● Posts
● Páginas
● Custom Post Types
Tipos de metadados
● Título
● Autor

● Posts
● Páginas
● Custom Post Types
Tipos de metadados
● Título
● Autor
● Custom Fields

Custom fields nativos
Apesar do WordPress já oferecer a funcionalidade de campos
personalizados (custom fields) de forma nativa, seu uso é
complexo tanto para quem desenvolve o site quanto,
principalmente, para quem alimenta o conteúdo.
● Não é intuitivo
● Sujeito a erros
● Sem validação
● Somente texto / literal
● Apenas Posts e CPTs
● Sem condicionais
● Interface muito limitada
● Precisa ser ativado em
cada tipo de conteúdo

Obtendo o valor de um campo
Campos personalizados nativos
$meta = get_post_meta( get_the_ID() );
if (!empty($meta))
$campo = $meta['nome_do_campo'];
if (!empty($campo))
foreach($campo as $valor)
echo $valor;
// Outra maneira
$primeiro_valor = get_post_meta(
get_the_ID(), 'nome_do_campo', true );
Advanced custom fields
$valor = get_field( "nome_do_campo"
);

Criando opções do tema
Options API
add_action('admin_menu',
'option_page_servicos_externos');function
option_page_servicos_externos() { add_options_page( 'Serviços
externos', 'Serviços externos', 'edit_pages',
'servicos_externos', 'options_page'); add_action( 'admin_init',
'register_settings' );} function register_settings() {
register_setting( 'youtube_group', 'youtube_playlist_id' );
register_setting( 'youtube_group', 'youtube_channel_url' );}
function options_page() {?><div class="wrap"><h1>Vídeos do
YouTube</h1><form method="post" action="options.php"> <?php
settings_fields( 'youtube_group' ); ?> <?php
do_settings_sections( 'youtube_group' ); ?> <table
class="form-table"> <tr valign="top"> <th scope="row">ID da
Playlist</th> <td><input type="text" name="youtube_playlist_id"
value="<?php echo esc_attr( get_option('youtube_playlist_id') );
?>" /></td> </tr> <th scope="row">URL do canal</th> <td><input
type="text" name="youtube_channel_url" value="<?php echo
esc_attr( get_option('youtube_channel_url') ); ?>" /></td> </tr>
</table> <?php submit_button(); ?></form></div><?php }
Advanced custom fields
acf_add_options_page();

Advanced Custom Fields
permite manipular dados tanto através da
interface administrativa quanto de funções
em PHP de maneira simplificada,
agilizando o desenvolvimento e a
utilização da plataforma.

Advanced Custom Fields
A grosso modo, é quase um “builder” para
o painel do WordPress, criando nas telas
de composição de conteúdo áreas extras
onde serão encaixados blocos flexíveis e
de extensa personalização.

Validação no back-end
add_filter('acf/validate_value/name
=numero', function ($valid, $value,
$field, $input) {
if ($value%2)
return 'Somente números
pares!';
return $valid;
}, 10, 4);

Exibição condicional de um campo

Exibição condicional de um grupo

Versionando via PHP
if( function_exists('acf_add_local_field_group') ):
acf_add_local_field_group(array(
'key' => 'group_5bfc72339289b',
'title' => 'Básico',
'fields' => array(
array(
'key' => 'field_5bfc7393f71fb',
'label' => 'Área de Texto',
'name' => 'area_de_texto',
'type' => 'textarea',
'instructions' => '',
'required' => 0,
'conditional_logic' => 0,
'wrapper' => array(
'width' => '',
'class' => '',
'id' => '',
),
'default_value' => '',
'placeholder' => '',
'maxlength' => '',
'rows' => 3,
'new_lines' => '',
),
// (...)

Versionando via JSON
[
{
"key": "group_5bfc72339289b",
"title": "Básico",
"fields": [
{
"key": "field_5bfc7393f71fb",
"label": "Área de Texto",
"name": "area_de_texto",
"type": "textarea",
"instructions": "",
"required": 0,
"conditional_logic": 0,
"wrapper": {
"width": "",
"class": "",
"id": ""
},
"default_value": "",
"placeholder": "",
"maxlength": "",
"rows": 3,
"new_lines": ""
},

Nem tudo é perfeito...
● Funcionalidades como repetidor, galeria, página de opções e
conteúdo flexível são exclusividades da versão paga.
● A versão paga é barata, com licença vitalícia para sites ilimitados.
● O ACF é “apenas” um front-end para os custom fields nativos.
● Os dados não estão associados aos posts, e sim aos custom fields.
● Jamais altere o nome ou tipo dos campos quando já existe conteúdo,
ou estes dados serão perdidos >_<”

Como manipular dados com ACF

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Semelhante a Como manipular dados com ACF

Semelhante a Como manipular dados com ACF (20)

Como manipular dados com ACF