kiss cultura de plugins

BUENAS PRÁCTICASKISS, CULTURA DE PLUGINS

/in/papoveda@povedica

Pablo Poveda Ortega

Me puedes ver en …

Donde hay una voluntad, hay un camino

Senior PHP Developer | WordPress Professional

Incondicional

KISS, CULTURA DE PLUGINS - BUENAS PRÁCTICAS

Chiclana, 7 y 8 de Octubre


FÁCIL DE APRENDER, DIFÍCIL DE DOMINAR


KISSKeep It Simple Stupid

(Simplifica estúpido)


DRYDont Repeat Yourself

(No te repitas)


DRTWDont Reinvent The Wheel

(No reinventes la rueda)


MENOS ES

MÁS


DIVIDEY

VENCERÁS


PIENSO, LUEGO PROGRAMO


NO TE VENGAS ARRIBA

(No si no tienes un plan)


APRENDE Y DISFRUTA POR EL CAMINO SIEMPRE

(recuerda que aquí hemos venido a jugar aunque a veces no lo parezca)


FACILITA EL TRABAJO A LOS DEMÁS


Copia, inspírate y mejóralo


CONTEXTO


WP FRIENDLY


TEN EN CUENTA QUE WORDPRESS EVOLUCIONA

CONSTANTEMENTE


TEN EN CUENTA QUE LOS PLUGINS DEBEN

CONVIVIR ENTRE ELLOSCOMPATIBILIDAD CONFLICTOVS

(Ej: Gravity Forms Debug Add-on)


(puedes usar clases con métodos que contengan estas funciones)

UTILIZA LAS FUNCIONES DE

WORDPRESS (DRTW)


UTILIZA BOILERPLATES

http://wppb.io/

wp scaffold plugin

(DRTW)

https://wppb.me/


FACILITA LA EXTENSIÓN Y/O MODIFICACIÓN DEL

COMPORTAMIENTO


EL ARTE DE HOOKEAR

add_action

do_action

remove_action

add_filter

apply_filter

remove_filter


DECIDE QUE PERMITES MODIFICAR, QUE

PERMITES EXTENDER


INTERNACIONALIZACIÓN

.pot .po .mo

_e()

__()


DETERMINA RESPONSABILIDADES USANDO ROLES Y CAPABILITIES


CÓDIGO LIMPIO(Clean code)


https://make.wordpress.org/core/handbook/best-practices/coding-standards/php/

USA LA GUÍA DE ESTILO DE CÓDIGO


NO TE OLVIDES DE QUE EL CÓDIGO QUE GENERAS ES PARA QUE:

1. LO LEAN Y EVOLUCIONEN PERSONAS

2. LO EJECUTEN MÁQUINASPrioridad


ESCRIBE CÓDIGO EN INGLÉS


( Programación Orientada a Objetos)

POO


EL ARTE DEL NAMING


USA PREFIJOS


USA NOMBRES SENSATOS PARA TODO


TU CÓDIGO SE DEBERÍA PODER LEER COMO UN LIBRO,

CON SENTIDO Y NO PARECER UN IDIOTA


UTILIZA PUNTOS ÚNICOS DE MODIFICACIÓN

(por ejemplo utiliza constantes)


USA CONSTANTES Y PUNTOS ÚNICOS DE MODIFICACIÓN


USA CONSTANTES Y PUNTOS ÚNICOS DE MODIFICACIÓN

MÁS DE 100 RESULTADOS


SEPARA LA LÓGICA DE TU MODELO DE DATOS


UTILIZA PATRONES DE DISEÑO SIEMPRE QUE PUEDAS

(SINGLETON, ADAPTER, …)


SEPARA LA VISTA

(usa templates)(permite sobreescribirlas)


DRY

DRY


DRY

DRY

PLANTILLA


DRY

DRY

PLANTILLA

“Adapter”


DRY

DRY

PLANTILLA

“Adapter”

SIMULACIÓN DE ADAPTER SIN USAR OO. DEVUELVE LA ESTRUCTURA DE DATOS (ARRAY) YA LISTA PARA USAR. LA


NO ABUSAR DE LOS COMENTARIOS EN EL

CÓDIGO



CÓDIGO

//WHEN I WROTE THIS, ONLY GOD AND I UNDERSTOOD WHAT I WAS DOING //NOW, GOD ONLY KNOWS

STOP(); // HAMMERTIME!

/// CLASS USED TO WORK AROUND RICHARD BEING A FUCKING IDIOT

// DRUNK, FIX LATER

//HAPPY DEBUGGING SUCKERS

RETURN 1; # RETURNS 1

//DONT TOUCH PLEASE

LONG JOHN; // SILVER



CÓDIGO




// DRUNK, FIX LATER



//DONT TOUCH PLEASE


LOL



CÓDIGO




// DRUNK, FIX LATER



//DONT TOUCH PLEASE


LOL

EL LISTILLO


DELEGA RESPONSABILIDADES SIMPLES (Divide y vencerás)

(Código Limpio)


CUIDA TODOS LOS CONTEXTOS


CONOCE EL FLUJO DE EJECUCIÓN DE WP

https://wordpress.stackexchange.com/questions/71406/is-there-a-flowchart-for-wordpress-loading-sequence

http://cdn2.wpbeginner.com/wp-content/uploads/2017/05/wp-behind-the-scenes.png

Detalles técnicos:

Infografía:


PUBLIC, ADMIN, AJAX, CRON


MULTISITE


THEMES Y CHILDTHEMES


CÓDIGO COMPATIBLE CON CLI (SHELL)



?



?PHP NOTICE: UNDEFINED INDEX


USO CORRECTO DE LA BD


LA BD ES LA REINA DEL AJEDREZ


LAS TABLAS DE WORDPRESS SEGURAMENTE SON

SUFICIENTES PARA CUBRIR LO QUE NECESITAS

(KISS)(dale una vuelta)


¿TABLAS NUEVAS? PIÉNSATELO DOS VECES

(o más)

CRUD no nativo

La interfaz casi la generas desde cero

Pierdes compatibilidad con WordPress

Mantenimiento de estructuraNadie espera esa tabla

Mantenimiento de queriesPosibilidad de queries no optimizadas


WP_QUERY +

WPDB


PRE_GET_POST


USA PRE_GET_POST ANTES QUE WP_QUERY

(una query puede ser mejor que dos)


USA LOS HOOKS PARA GESTIONAR QUERIES

https://codex.wordpress.org/Custom_Queries


VALIDA LO QUE SE GUARDA EN BD DESDE

TU PLUGIN


NO ABUSES DE LAS QUERIES

(menos es más)


OPTIMIZA TUS QUERIES

https://es.wordpress.org/plugins/query-monitor/


USA PREPAREhttps://developer.wordpress.org/reference/classes/wpdb/prepare/


SI NECESITAS QUERIES COMPLEJAS CON SUBQUERIES, JOINS Y/O USAR OFFSET,LIMIT CUIDA MUY BIEN EL

PERFORMANCE Y MIDE CON HERRAMIENTAS


EVITAR LOS CUELLOS DE BOTELLA


USA TÉCNICAS DE PROCESADO POR BLOQUES (CHUNKS) PARA

PROCESAR GRANDES CANTIDADES DE DATOS

Ejemplo: Exportar/Importar datos desde una fuente externa


CACHÉ SI, CACHÉ NOUSA UNA ESTRATEGIA Y NO IMPROVISES


UIADMIN

SCREENS FRONT(public)(dashboard)


WP FRIENDLY


EVITA CONFLICTOS

¿Sabéis cual es la regla del !important?


HTML, CSS Y JAVASCRIPT SIGUE SIENDO CÓDIGO

(código limpio)


CARGAS CONDICIONALES(carga lo mínimo en cada petición)


SI EXISTEN POCOS SETTINGS PIENSA DONDE

PRESENTARLOS(no siempre tener tu propio menú es lo mejor)

(KISS)


USA LAS FUNCIONES DE WORDPRESS PARA GESTIONAR

LAS PANTALLAS Y LOS SETTINGS DE BACKOFFICE


https://codex.wordpress.org/Settings_API


HTTPS COMPATIBLE


USA FUNCIONES DE WORDPRESS PARA AÑADIR EL JAVASCRIPT Y CSS QUE DARÁN FORMA, COLOR Y COMPORTAMIENTO A LAS

PANTALLAS(se aplica el mismo criterio: WP Friendly)


wp_enqueue_script

wp_dequeue_script

wp_enqueue_style

wp_dequeue_style

wp_add_inline_script

wp_add_inline_style

wp_register_style

wp_deregister_style

wp_register_script

wp_deregister_script

wp_script_is

wp_localize_script

wp_enqueue_media

admin_enqueue_scripts

admin_print_scripts

admin_print_styles

add_action (‘wp_head','hook_inHeader');

add_action( 'admin_head', 'my_custom_admin_head' );

Funciones WP para gestión de assets


wp_enqueue_script

wp_dequeue_script

wp_enqueue_style

wp_dequeue_style

wp_add_inline_script

wp_add_inline_style

wp_register_style

wp_deregister_style

wp_register_script

wp_deregister_script

wp_script_is

wp_localize_script

wp_enqueue_media

admin_enqueue_scripts

admin_print_scripts

admin_print_styles

add_action (‘wp_head','hook_inHeader');

add_action( 'admin_head', 'my_custom_admin_head' );

¿AÚN TIENES EXCUSAS?

Funciones WP para gestión de assets


SI PUEDES, USA ALGUNAS TÉCNICAS WPO PARA OPTIMIZAR

LA CARGA DE LAS PÁGINAS


FACILITA SHORTCODES


BUSCADOR


NO ABUSES DEL PRE_GET_POSTS


EVITAR LOS CUELLOS DE BOTELLA


REALIZA BÚSQUEDAS CONDICIONADAS AL CONTEXTO DE BÚSQUEDA


POR SUPUESTO, FILTRA Y VALIDA LAS CADENAS DE BÚSQUEDA DE

LOS USUARIOS(ojito con las cadenas que llegan por $_GET[’s'])


SEGURIDADXSS SQL

INYECTION SSISESSION

CAPTURING AND HIJACKING

CODE INJECTION

VALIDACIÓN DE CAMPOS

VALIDA TODAS LAS PETICIONES

PREPARE SQL

ESCAPA CADENAS

LIMITA EL USO CON

CAPABILITIES


EXTENSIÓN DE TERCEROS


RESPETOmuchos han trabajado, trabajan y

trabajarán a cambio de nada o muy poco


USA CORRECTAMENTE LOS HOOKS

DISPONIBLES


USA CORRECTAMENTE LOS HOOKS

DISPONIBLES

HOOK


SÉ FUERTE NO MODIFIQUES EL

CÓDIGO DE UN TERCERO


RESPETA LOS LÍMITES DE LA EXTENSIÓN PERMITIDA, NO TE EXCEDAS, NO

MODIFIQUES COMPORTAMIENTO QUE NO ESTÁ PENSADO PARA TAL PROPÓSITO


EJEMPLO CLAROLAS EXTENSIONES DE

WOOCOMMERCE


API RESThttps://developer.wordpress.org/rest-api/


BUGS, DEBUG, FIX, UPDATE

Debug Bar + Add-ons

Query Monitor

P3 Profilerxdebug +


GESTOR DE TAREAS, ISSUE TRACKER


NO DEJES HUELLA


DOCUMENTA TODO LO QUE HACES

(Facilita el trabajo a los demás)


FEEDBACK(Escucha a tus usuarios)


POLITICA DE ACTUALIZACIONES TENIENDO EN CUENTA TODOS

LOS CAMBIOS


1.Olfato

2.Opiniones de camaradas

3.Frecuencia de actualizaciones

4.Issues

5.Soporte

6.Compatibilidad

7.Reviews

8.Calidad de código y performance

MI CRITERIO PARA SELECCIONAR UN

PLUGIN

kiss cultura de plugins

Technology