Kiss cultura de plugins

BUENAS PRÁCTICAS
KISS, 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

FÁCIL DE APRENDER,
DIFÍCIL DE DOMINAR

KISSKeep It Simple Stupid
(Simpliﬁca estúpido)

DRYDont Repeat Yourself
(No te repitas)

DRTWDont Reinvent The Wheel
(No reinventes la rueda)

MENOS  
ES  
MÁS

DIVIDE 
Y 
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 ELLOS
COMPATIBILIDAD 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ÁQUINAS
Prioridad

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

NO ABUSAR DE LOS
COMENTARIOS EN EL
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

NO ABUSAR DE LOS
COMENTARIOS EN EL
CÓDIGO
// DRUNK, FIX LATER
//DONT TOUCH PLEASE
LOL

NO ABUSAR DE LOS
COMENTARIOS EN EL
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-ﬂowchart-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)

CLI (SHELL)
?

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 estructura
Nadie espera esa tabla
Mantenimiento de queries
Posibilidad 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
QUERIEShttps://es.wordpress.org/plugins/query-monitor/

USA PREPARE
https://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É NO
USA UNA ESTRATEGIA Y NO IMPROVISES

UI
ADMIN
SCREENS FRONT
(public)(dashboard)

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

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
SSI
SESSION
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 CLARO 
LAS EXTENSIONES DE
WOOCOMMERCE

API REST
https://developer.wordpress.org/rest-api/

BUGS, DEBUG, FIX,
UPDATE
Debug Bar + Add-ons
Query Monitor
P3 Proﬁler
xdebug +

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

Recomendados

Recomendados

Más contenido relacionado

Último

Último (20)

Destacado

Destacado (20)

Kiss cultura de plugins