Casi todos los casos de estudio que se publican en esta industria son de proyectos bonitos. Un rediseño que quedó lindo, una tienda que subió las ventas. Este no es de esos.
Este proyecto tiene una particularidad que lo hace interesante como ejercicio técnico: opera en un vertical donde la ley no es un anexo del proyecto sino parte de la arquitectura. No puedes ponerle un párrafo de términos y condiciones y seguir. Tienes que escribir el cumplimiento dentro del código, porque si el sistema permite algo que la ley prohíbe, el problema no es de política de uso: es del sistema.
Además me obligó a resolver cosas que en un proyecto normal no aparecen: URLs jerárquicas de tres niveles con miles de combinaciones, verificación de identidad con documentos que nunca pueden ser públicos, y un modelo de cobro por visibilidad con vencimiento automático.
Por confidencialidad no menciono ni el cliente ni el sector. Todo lo demás es exacto: las versiones, los archivos, los bugs y los precios.
Qué me pidieron
construir.
El encargo llegó descrito como "un directorio". Después de la primera reunión quedó claro que era un marketplace completo con estas piezas:
- Registro público autogestionado. El proveedor del servicio crea su propio perfil, sube documentos de identidad y espera aprobación. Sin intervención manual salvo en la moderación.
- Verificación de identidad obligatoria. Documento por ambos lados más una selfie sosteniéndolo. Esos archivos nunca pueden ser públicos.
- Cinco niveles de visibilidad con cobro semanal y vencimiento automático.
- Ocho ciudades con zonas dentro de cada una, y URLs que reflejen esa jerarquía.
- Sistema de reseñas con calificaciones por criterio y posibilidad de respuesta.
- Canal de reportes con categorías críticas que disparan alerta inmediata.
- Panel propio para que cada proveedor gestione su perfil sin tocar el admin de WordPress.
Nada de eso existe empaquetado. Hay plugins de directorio genéricos, pero ninguno resuelve verificación de identidad con custodia de documentos, ni jerarquía de URLs de tres niveles, ni un modelo de cobro por visibilidad con vencimiento. Tocaba construirlo.
Los dos pivots de stack
antes de arrancar en serio.
Esta parte la cuento porque me parece la más útil para cualquiera que esté decidiendo con qué construir.
Arrancamos en WordPress. A las pocas semanas propusimos migrar a Next.js: mejor rendimiento, control total del frontend, la decisión que cualquier desarrollador habría defendido en una reunión técnica. Montamos un sprint completo en Next.js 15.
Y después volvimos a WordPress.
No por un problema técnico. Por una razón mucho más importante: el cliente conoce WordPress y no conoce Next.js. Puede entrar al admin, cambiar un texto, subir una imagen, revisar un perfil pendiente. Con Next.js dependía de mí para cada cambio.
Perdimos unas semanas en ese ida y vuelta. Pero la decisión final fue la correcta, y prefiero perder tres semanas que entregar algo que el cliente no pueda operar.
La arquitectura de URLs
y el bug que me costó una semana.
Esta es la parte que más le va a servir a quien haya peleado con reglas de reescritura en WordPress.
Lo que necesitábamos
Cada perfil tenía que vivir en una URL que reflejara ciudad y zona, porque esa jerarquía es la que sostiene todo el SEO local del proyecto:
// Estructura objetivo
/medellin/el-poblado/nombre-del-perfil/
/bogota/chapinero/otro-perfil/
/cali/granada/tercer-perfil/
// Y además, landings propias de cada nivel
/medellin/ ← landing de ciudad
/medellin/el-poblado/ ← landing de zona
Ocho ciudades con varias zonas cada una. La jerarquía de URL es lo que le dice a Google que el contenido es local y a qué nivel de granularidad.
El error que parecía obvio y no lo era
La forma intuitiva de hacerlo es registrar el tipo de contenido con placeholders en el slug de reescritura. Algo así:
// Esto NO funciona
register_post_type('escort', [
'rewrite' => [
'slug' => '%ec_ciudad%/%ec_zona%',
'with_front' => false,
],
]);
Parece razonable. WordPress no lo interpreta así.
WordPress toma esos placeholders de forma literal. Genera reglas de reescritura que buscan la cadena de texto %ec_ciudad% en la URL, no el valor de la taxonomía. Esas reglas nunca coinciden con nada, y el resultado es 404 en todos los perfiles del sitio.
Y había un segundo problema encima. La taxonomía de ciudad estaba registrada con slug vacío para que las URL quedaran limpias. Eso hace que la taxonomía capture cualquier URL de un solo segmento. O sea que además de los perfiles, se cayeron las páginas normales: contacto, términos, blog. Todo.
Cómo lo resolví
La solución fue dejar de pedirle a WordPress que adivine y construir las reglas explícitamente desde los slugs de ciudad reales:
// Clase Rewrites: genera las reglas desde los datos reales
foreach ($ciudades as $ciudad) {
$c = $ciudad->slug;
// 1. Paginación PRIMERO. Este orden es crítico:
// si va después, el patrón genérico se come /page/2/
add_rewrite_rule(
"^{$c}/page/([0-9]+)/?$",
'index.php?ec_ciudad=' . $c . '&paged=$matches[1]',
'top'
);
// 2. Perfil dentro de zona, con lookahead negativo
// para que /page/ nunca entre como si fuera una zona
add_rewrite_rule(
"^{$c}/((?!page/)[^/]+)/([^/]+)/?$",
'index.php?post_type=escort&name=$matches[2]',
'top'
);
// 3. Landing de zona
add_rewrite_rule(
"^{$c}/((?!page/)[^/]+)/?$",
'index.php?ec_ciudad=' . $c . '&ec_zona=$matches[1]',
'top'
);
// 4. Landing de ciudad, la más genérica va de último
add_rewrite_rule(
"^{$c}/?$",
'index.php?ec_ciudad=' . $c,
'top'
);
}
Dos detalles que parecen menores y no lo son: el orden de las reglas y el lookahead negativo. Sin cualquiera de los dos, la paginación se rompe en silencio.
Entre encontrar la causa, entender el segundo problema del slug vacío y dejar el orden de reglas estable, se me fue una semana completa. Lo dejo escrito acá para que a alguien más no le pase.
Cumplimiento legal escrito
en el código.
Acá está la diferencia entre un proyecto de vertical regulado y uno normal. Tres leyes colombianas que no quedaron en el documento de términos sino dentro del sistema.
Protección de menores
La Ley 1336 de 2009 sanciona la publicidad que promueva servicios sexuales con menores de edad. Lo que hice:
- Validación de edad del lado del servidor, no solo en el formulario. Si alguien manipula el HTML, el rechazo ocurre igual.
- Cuando el rechazo se dispara, la pantalla no dice solo "no puedes registrarte": muestra la línea 141 del ICBF y el 018000-522020 de la línea contra la trata.
- Verificación con documento por ambos lados más selfie sosteniéndolo, con revisión manual antes de publicar.
Habeas Data
La Ley 1581 de 2012 regula el tratamiento de datos personales. Dos decisiones técnicas concretas:
// Las IPs nunca se guardan en claro
$ip_hash = hash('sha256', $ip . wp_salt('auth'));
// Sirve para detectar abuso y votos duplicados,
// pero no reconstruye quién visitó qué perfil
Puedes contar visitas únicas y frenar abuso sin conservar un dato que, en este vertical, sería material sensible si alguna vez se filtra la base.
Los documentos de verificación se conservan después de aprobar el perfil, pero en carpeta privada protegida a nivel de servidor, nunca publicados, accesibles solo con permiso explícito y con registro de cada acceso. Si alguien del equipo abre un documento, queda constancia.
Prevención de trata
La Ley 985 de 2005 adopta medidas contra la trata de personas. En el sistema, dos categorías de reporte están marcadas como críticas y se muestran destacadas en el panel de administración, con las líneas de denuncia visibles al lado. No entran en la cola normal de moderación.
El schema de nueve tipos
y la estrategia de keywords.
Por qué un grafo y no un bloque suelto
Cada perfil emite un grafo de schema con nueve tipos conectados entre sí. No son nueve bloques sueltos: es un grafo donde cada nodo referencia a los otros con identificadores, para que el buscador entienda que la persona, el servicio, la ubicación y las reseñas son partes de la misma entidad.
Ese nivel de detalle en un directorio de miles de perfiles es lo que hace la diferencia entre que Google entienda la estructura o la trate como páginas sueltas.
La estrategia de keywords
Acá aplicamos algo que he escrito en otros artículos: el término con más volumen no siempre es el término correcto.
| Nivel | Tipo de término | Por qué |
|---|---|---|
| Primario | El colombianismo local | Alta intención de compra, competencia internacional mucho menor porque solo se usa acá |
| Secundario | El término internacional | Captura turismo y búsquedas desde fuera del país |
| Complementario | El término neutro | Segmento que evita el vocabulario más directo |
El primario es el que manda la arquitectura de contenido, aunque en volumen absoluto no sea el más grande. Un término que solo se usa en Colombia tiene una ventaja enorme: los sitios internacionales con autoridad de dominio brutal no lo están trabajando.
Las tres veces
que le dije que no.
Un caso de estudio donde el proveedor solo cuenta lo que salió bien no sirve de mucho. Estas son las tres decisiones donde no hice lo que me pidieron, y por qué.
La categoría que no implementé
Me pidió replicar la lista de categorías de un competidor. La implementé completa menos una, porque en ese contexto esa palabra significa apariencia de menor de edad.
Le expliqué tres razones. La primera es legal: la Ley 1336 sanciona la publicidad que promueva servicios sexuales con menores, y una categoría cuyo significado en el sector es ese te pone en una conversación que no quieres tener. La segunda es operativa: ese vocabulario dispara revisiones automáticas en buscadores, redes de distribución de contenido y pasarelas de pago. La tercera es que el segmento que él quería cubrir ya estaba cubierto por otra categoría sin ninguno de esos problemas.
Lo aceptó. Y dejé un test automatizado que verifica que ese vocabulario no vuelva a aparecer en el código, porque en un equipo que crece alguien puede agregarlo sin conocer el contexto.
La obligatoriedad total que habría roto los filtros
Me pidió que todos los campos del formulario fueran obligatorios. Suena razonable hasta que miras la estructura de datos.
Hay grupos de opciones que tienen una sola alternativa. Si haces obligatorio un grupo de una sola opción, todo el mundo la marca, y entonces ese filtro queda inservible: filtras por esa característica y te devuelve el catálogo entero.
La solución fue distinguir entre grupos descriptivos y excluyentes, que sí son obligatorios, y grupos aditivos, que no. Quedaron doce obligatorios y ocho opcionales, con una bandera por grupo que se cambia en una línea si él quiere ajustar el criterio después.
El hosting que le advertí
El proyecto vive en un hosting compartido de un proveedor grande. Le advertí que un vertical de este tipo en hosting mainstream es un riesgo de suspensión latente, y le di alternativas de proveedores que sí aceptan el sector explícitamente.
Decidió quedarse donde está por costo. Es su decisión y la respeto, pero quedó por escrito. Si algún día llega la suspensión, no va a ser una sorpresa.
Qué hay construido
hoy.
Estado al momento de escribir esto, con los números reales de los archivos entregados.
El plugin, versión 1.6.0
Unos 106 KB, 33 archivos PHP, requiere PHP 8.1 o superior. Contiene:
- Tipo de contenido propio con las URL jerárquicas de tres niveles
- Nueve taxonomías, seis públicas y tres internas
- Cuatro roles de usuario con permisos diferenciados
- Cuatro tablas propias: reseñas con calificaciones por criterio, pagos, reportes y registro de visitas
- Sistema de cinco niveles de visibilidad con tarea programada de vencimiento
- Registro público en asistente de once pasos
- Panel del proveedor con nueve secciones
- Moderación de perfiles y de reseñas
- Gestión de reportes con marcado de casos críticos
- Registro de visitas y de clics de contacto
- Capa de compatibilidad con Yoast
El tema, versión 1.4.0
Unos 50 KB. Plantillas propias para inicio, perfil individual con el grafo de schema, landing de ciudad, landing de zona, directorio, blog, páginas y error 404. Los textos alternativos de las imágenes se generan con el formato que necesita el negocio para búsqueda por imágenes.
Lo que sigue
| Pendiente | Qué implica |
|---|---|
| Buscador con filtros en las landings de ciudad | Es lo principal que falta. La base ya está: las taxonomías, los grupos y los datos de prueba |
| Pagos con comprobante manual | Subir soporte, confirmar desde el admin y activar el nivel. La tabla ya existe |
| Despliegue y optimización | Rendimiento, caché, imágenes y paso a producción |
Cuánto cuesta
un proyecto así.
Te lo desgloso por componentes, porque casi nadie publica esto y creo que hace falta.
Plugin a la medida
Es el corazón del proyecto y donde se va la mayor parte del trabajo. Incluye:
- Modelo de datos y tablas propias
- Tipos de contenido, taxonomías y roles
- Arquitectura de URLs y reglas de reescritura
- Registro público y panel del usuario
- Flujos de moderación y reportes
- Sistema de niveles con vencimiento automático
- Cumplimiento normativo implementado en código
Tema a la medida
Plantillas propias para cada tipo de página, diseño responsivo, identidad visual aplicada y el grafo de schema por perfil. No es una plantilla comprada con ajustes: es código escrito para este modelo de datos.
Arquitectura SEO y contenido base
Estrategia de palabras clave, arquitectura de URLs pensada para SEO local, schema estructurado, redacción de las páginas legales y del contenido base del sitio, y configuración técnica completa.
Despliegue, pruebas y documentación
Paso a producción, pruebas de carga, optimización de rendimiento, herramientas de diagnóstico y documentación para que el cliente pueda operar sin depender de la agencia para todo.
Qué mueve el precio dentro del rango
| Factor | Efecto |
|---|---|
| Cantidad de reglas de negocio propias | Cada flujo que no existe empaquetado suma desarrollo |
| Marco regulatorio del sector | Verticales regulados suman validaciones, auditoría y custodia de datos |
| Número de roles y permisos | Cada rol multiplica los casos a probar |
| Integraciones de pago | Pasarela estándar es rápido; flujos manuales con comprobante son más trabajo del que parece |
| Volumen de contenido inicial | Redactar páginas legales y contenido base no es gratis |
Cómo estructuro el pago
Anticipo del 40% para arrancar
Cubre descubrimiento, modelo de datos, arquitectura de URLs y el primer bloque de desarrollo. Es la fase donde se define todo lo demás.
30% contra entrega funcional
Plugin y tema funcionando en ambiente de pruebas, con el flujo completo operativo de punta a punta.
30% contra puesta en producción
Sitio en producción, optimizado, documentado y con el cliente capacitado para operarlo.
Preguntas frecuentes
sobre este tipo de proyecto.
¿Cuánto cuesta desarrollar un marketplace a la medida en WordPress?
Entre 28 y 42 millones de pesos colombianos, o entre 7.000 y 10.500 dólares, para un proyecto con plugin y tema propios, arquitectura de URLs jerárquica, schema estructurado y cumplimiento normativo integrado. El rango depende de cuántas reglas de negocio propias tenga y de qué tan estricto sea el marco regulatorio del sector.
¿Por qué construir a la medida y no usar un plugin de directorio?
Los plugins de directorio resuelven bien los casos genéricos. Cuando necesitas verificación de identidad con custodia de documentos, URLs jerárquicas de tres niveles, niveles de visibilidad con vencimiento automático y validaciones normativas del lado del servidor, ninguno lo cubre. Terminas peleando contra el plugin en vez de construir.
¿Por qué WordPress y no Next.js o un framework moderno?
En este proyecto hicimos ese cambio y volvimos atrás. Next.js rinde mejor, pero el cliente no lo conoce y quedaba dependiendo del desarrollador para cada cambio de texto. WordPress bien construido le deja el control a él. El stack se elige por quién va a mantener el sistema, no solo por lo que rinde en un benchmark.
¿Por qué fallan las URL con placeholders en el slug de reescritura?
Porque WordPress interpreta los placeholders del tipo por ciento nombre por ciento de forma literal y genera reglas que buscan esa cadena de texto en la URL, no el valor de la taxonomía. Esas reglas nunca coinciden y el resultado es 404 en todo el tipo de contenido. La solución es construir las reglas explícitamente desde los slugs reales, cuidando el orden y usando lookahead negativo para que la paginación no se rompa.
¿Cuánto tarda un desarrollo de este tipo?
Entre cuatro y seis meses de trabajo efectivo para un alcance como el descrito. En este caso se alargó por los dos cambios de stack al inicio, que costaron unas semanas. El descubrimiento y el modelo de datos son la fase que más determina el resto: si se hace mal, se paga después en retrabajos.
¿Cómo se maneja el cumplimiento legal en un proyecto de vertical regulado?
Escribiéndolo dentro del código, no solo en los términos y condiciones. Validaciones del lado del servidor que no se pueden saltar manipulando el formulario, custodia de documentos sensibles en carpeta privada con registro de accesos, datos personales tratados con las restricciones que exige la norma, y canales de reporte con categorías críticas que no entran en la cola normal de moderación.
¿Qué no está incluido en el precio de desarrollo?
Hosting, dominio, revisión legal de los términos con un abogado del sector, constitución de la sociedad si aplica, registro de bases de datos ante la autoridad de protección de datos y el mantenimiento mensual posterior. En verticales regulados, la revisión legal no es opcional: es parte del costo real del proyecto.
¿Se puede convivir con Yoast SEO en un desarrollo a la medida?
Sí, y conviene. En este proyecto el plugin detecta si Yoast está activo: cuando lo está, desactiva su propio sitemap y robots.txt para no duplicar, y le agrega hooks a Yoast para que incluya el tipo de contenido nuevo. El schema estructurado propio se sigue emitiendo siempre, porque es específico del negocio y Yoast no lo cubre.
Contenido relacionado
del ecosistema Webhexup.
Llevo casi veinte años haciendo SEO técnico y desarrollo con marcas de Colombia y Estados Unidos. Los casos que publico incluyen los bugs que me costaron tiempo y las veces que le dije que no al cliente, porque un caso donde todo salió perfecto no le enseña nada a nadie. Y publico los precios, que casi nadie lo hace.
Escríbeme: LinkedIn · WhatsApp +57 313 682 9935