"ACF: Um canivete suíço para seus dados" (Rudá Almeida) - Muitas vezes um projeto tem particularidades que a estrutura nativa do WordPress não atende sem algum nível de adaptação. Extremamente flexível, o Advanced Custom Fields te permite criar tipos personalizados de dados com extrema rapidez e facilidade, agilizando imensamente o processo de desenvolvimento.

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

2. 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

3. Como manipular dados
usando Advanced
Custom Fields

4. O que são dados?

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

6. Dados nativos no WordPress

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

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

9. 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.

10. Um exemplo

11. 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

12. 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

13. Dados nativos no WordPress
Tipos de publicações
● Posts
● Páginas
● Custom Post Types
Tipos de metadados
● Título
● Autor
● Data e hora de publicação
● Imagem de destaque

14. Dados nativos no WordPress
Tipos de publicações
● Posts
● Páginas
● Custom Post Types
Tipos de metadados
● Título
● Autor
● Data e hora de publicação
● Imagem de destaque
● Custom Fields

15. Custom Fields nativos

16. 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

19. 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"
);

20. 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();

21. Advanced Custom Fields

22. Advanced Custom Fields

23. 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.

24. 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.

28. Tipos de campos do ACF

29. Tipos básicos

30. Múltipla escolha

31. Conteúdo

32. Conteúdo (cont.)

33. jQuery

34. Repetidor

35. Relacional

36. Validação

37. Validação no front-end

38. 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);

39. Exibição condicional

40. Exibição condicional de um campo

41. Exibição condicional de um grupo

42. Versionamento

43. 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' => '',
),
// (...)

44. 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": ""
},

45. VAMOS VER NA PRÁTICA?

47. Observações

48. 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 >_<”

49. OBRIGADO!

50. “ONE LAST THING…”

55. PERGUNTAS?