Saltar al contenido
Agencia SEO-first · Colombia y Estados Unidos +57 313 682 9935 hola@webhexup.com Propuesta SEO gratis

/ Caso de estudio · Desarrollo y SEO

Un marketplace con verificación de identidad y cumplimiento legal escrito en el código: cómo lo construimos y qué cuesta.

Marketplace WordPress a la medida: cómo lo hice y qué cuesta
JF
José Fernando Muñoz Álvarez
Consultor SEO, GEO y AI Visibility · Fundador de Webhexup · Medellín, Colombia · LinkedIn
Este es el desglose de un proyecto que llevo varios meses construyendo: un marketplace de servicios personales en un vertical regulado, con perfiles verificados por documento, cobro por niveles de visibilidad y ocho ciudades operando. Todo sobre WordPress, con plugin y tema hechos a la medida. Te cuento las decisiones técnicas, el bug que me costó una semana entera, las tres veces que le dije que no al cliente y cuánto vale un desarrollo así.

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.

33
archivos PHP en el plugin a la medida
4
tablas propias en base de datos
9
tipos de schema en el grafo del perfil
3
leyes colombianas implementadas en código
El encargo

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.

Decisión de stack

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.

La lección que me llevo. El stack no se elige por lo que rinde mejor en un benchmark, sino por quién va a mantener eso cuando la agencia no esté. Un sitio en Next.js que el cliente no puede tocar se vuelve una dependencia. Un WordPress bien construido que el cliente maneja se vuelve un activo suyo. El código del sprint en Next.js quedó archivado; los demos visuales que hicimos ahí sirvieron como referencia de diseño.

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.

Arquitectura

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.

El detalle que hay que documentarle al cliente. Estas reglas se generan al activar el plugin. Si alguien agrega una ciudad nueva y no guarda los enlaces permanentes, esa ciudad devuelve 404 y nadie entiende por qué. Le dejé una herramienta de diagnóstico que revisa qué reglas están efectivamente guardadas y cómo resuelve cada URL, porque este es el tipo de cosa que se te olvida seis meses después.

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

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.

Por qué esto importa más allá de lo legal. Un sistema que hace fácil lo correcto y difícil lo incorrecto se defiende solo. Si el cumplimiento vive únicamente en un documento que nadie lee, depende de que todos los operadores hagan siempre lo correcto. Si vive en el código, el sistema no te deja hacer lo otro.
Hablemos por WhatsApp
¿Tienes un proyecto que ningún
plugin del mercado resuelve?

Marketplaces, directorios con verificación, sistemas de membresía, plataformas con reglas de negocio propias. Cuéntame qué necesitas y te digo si se resuelve con lo que existe o si toca construirlo.

SEO

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.

Un detalle de convivencia con Yoast que vale la pena saber. El cliente ya tenía Yoast instalado. En vez de pelear, el plugin lo detecta: cuando Yoast está activo, desactiva su propio sitemap y su propio robots.txt para no duplicar, y le agrega hooks a Yoast para que incluya el tipo de contenido nuevo. El grafo de schema propio se sigue emitiendo siempre, porque es específico del negocio y Yoast no lo cubre. Cada herramienta hace lo que hace bien.

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.

NivelTipo de términoPor qué
PrimarioEl colombianismo localAlta intención de compra, competencia internacional mucho menor porque solo se usa acá
SecundarioEl término internacionalCaptura turismo y búsquedas desde fuera del país
ComplementarioEl término neutroSegmento 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.

Criterio

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.

Por qué cuento esto. El trabajo de una agencia no es ejecutar todo lo que pide el cliente. Es decirle cuándo lo que pide le va a hacer daño, explicarle por qué, y dejarlo documentado. Después él decide. Pero si no se lo dices, el error es tuyo.
Entregables

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

PendienteQué implica
Buscador con filtros en las landings de ciudadEs lo principal que falta. La base ya está: las taxonomías, los grupos y los datos de prueba
Pagos con comprobante manualSubir soporte, confirmar desde el admin y activar el nivel. La tabla ya existe
Despliegue y optimizaciónRendimiento, caché, imágenes y paso a producción
Inversión

Cuánto cuesta
un proyecto así.

Un desarrollo de este alcance, con plugin y tema a la medida, arquitectura de URLs jerárquica, schema completo y cumplimiento legal integrado, está entre 28 y 42 millones de pesos en el mercado colombiano. En dólares, entre 7.000 y 10.500. El rango depende de cuántas reglas de negocio propias haya y de qué tan estricto sea el marco regulatorio del sector.

Te lo desgloso por componentes, porque casi nadie publica esto y creo que hace falta.

Componente 1

Plugin a la medida

$14.000.000 – $20.000.000
USD 3.500 – 5.000

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

Tema a la medida

$7.000.000 – $11.000.000
USD 1.750 – 2.750

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.

Componente 3

Arquitectura SEO y contenido base

$5.000.000 – $8.000.000
USD 1.250 – 2.000

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.

Componente 4

Despliegue, pruebas y documentación

$2.000.000 – $3.000.000
USD 500 – 750

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

FactorEfecto
Cantidad de reglas de negocio propiasCada flujo que no existe empaquetado suma desarrollo
Marco regulatorio del sectorVerticales regulados suman validaciones, auditoría y custodia de datos
Número de roles y permisosCada rol multiplica los casos a probar
Integraciones de pagoPasarela estándar es rápido; flujos manuales con comprobante son más trabajo del que parece
Volumen de contenido inicialRedactar páginas legales y contenido base no es gratis

Cómo estructuro el pago

1

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.

2

30% contra entrega funcional

Plugin y tema funcionando en ambiente de pruebas, con el flujo completo operativo de punta a punta.

3

30% contra puesta en producción

Sitio en producción, optimizado, documentado y con el cliente capacitado para operarlo.

Lo que no está incluido y hay que presupuestar aparte. Hosting, dominio, revisión legal de términos y condiciones 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 después de la entrega. En un vertical regulado, la revisión legal no es opcional: es parte del costo real del proyecto.
Cotización
Te armo la propuesta
con el alcance real de tu proyecto.

Los rangos de arriba son referencia. Para darte un número real necesito entender tu modelo de negocio, qué reglas propias tiene y qué marco regulatorio aplica. Una llamada de cuarenta minutos suele bastar para eso.

Preguntas frecuentes

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.

Te puede interesar

Contenido relacionado
del ecosistema Webhexup.

JF
José Fernando Muñoz Álvarez
Consultor SEO, GEO y AI Visibility · Fundador de 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

Empecemos
Si lo que necesitas no existe empaquetado,
hay que construirlo bien desde el principio.

Un modelo de datos mal pensado en el mes uno se paga con intereses en el mes seis. Cuéntame qué tienes en mente y te digo con franqueza si se resuelve con lo que ya existe o si vale la pena construirlo.

¿Listo para que te encuentren en Google y en la IA?

Cuéntanos tu proyecto y te respondemos en menos de 24 horas con una propuesta real.

Te respondemos en menos de 24 horas

Antes de hablar por WhatsApp

Cuéntanos quién eres y qué necesitas para responderte con la información correcta.

Preferencias de privacidad

Elige qué cookies aceptas. Las necesarias siempre están activas.

No vender ni compartir mi información personal
Si desactivas «Marketing y publicidad», no venderemos ni compartiremos tus datos personales para publicidad dirigida (CCPA/CPRA y leyes estatales de EE. UU.).