Autor: sergio

Hoy quiero compartir mi experiencia desarrollando una API personalizada para WHMCS, que permite consultar si un cliente existe en el sistema utilizando un dato de entrada, como su ID de cliente, DNI o CUIT. Este proyecto surgió como parte de una solicitud para integrarse con un script externo que debía consultar esta información a través de una API desde una central telefónica.

El Problema y su Análisis

El requerimiento era bastante simple: validar si un cliente existía en WHMCS y devolver los datos básicos del mismo, como su nombre, apellido y correo electrónico. La idea era permitir que un sistema externo, en este caso una central telefónica, pudiera consultar esta información mediante una solicitud a la API, facilitando la identificación del cliente durante las llamadas.

La Solución: Una API de Consulta de Clientes

Para resolver el problema, desarrollé una API personalizada que responde a las consultas en el siguiente formato JSON:

{
	"result": "success",
	"totalresults": 1,
	"clients": [
		{
			"client_id": *****,
			"firstname": "sergio",
			"lastname": "rios",
			"email": "******@gmail.com"
		}
	]
}

La API acepta como parámetros el ID de cliente, el DNI o el CUIT, y devuelve una respuesta indicando si el cliente existe y, en caso afirmativo, proporciona sus datos. Si el cliente no es encontrado, la respuesta sería diferente, reflejando que no se obtuvieron resultados.

¿Qué es una API y cómo se consume?

Una API (Interfaz de Programación de Aplicaciones) es un conjunto de funciones y protocolos que permiten la comunicación entre diferentes aplicaciones. En el caso de esta API para WHMCS, se trata de una forma de exponer ciertos datos del sistema (como los clientes) para que puedan ser utilizados por otros servicios externos.

Para consumir la API, puedes utilizar herramientas como Insomnia o Postman, que son populares para probar y realizar solicitudes HTTP de manera sencilla. A continuación, te explico cómo hacerlo:

1. Configuración de la solicitud: En Postman o Insomnia, crea una nueva solicitud del tipo GET o POST, dependiendo de cómo hayas configurado la API. Especifica la URL de tu endpoint y los parámetros requeridos (ID de cliente, DNI o CUIT).
2. Autenticación: Si tu API requiere autenticación, configura los encabezados necesarios o el token de acceso.
3. Ejecuta la solicitud: Al enviar la solicitud, la herramienta te mostrará la respuesta en formato JSON, permitiéndote verificar si la API responde correctamente con la información del cliente.

Todo esto tuve que documentarlo explicando un poco los parámetros necesarios, proporcionando autenticación necesaria, y explicando el funcionamiento.
Pueden encontrar la documentación si les interesa en mi cuenta de hithub.

Conclusión

Crear esta API me permitió reforzar el concepto de cómo funciona una API y cómo integrarla con sistemas externos. Aunque era una funcionalidad sencilla, es un buen ejemplo de cómo podemos exponer información de manera segura y estructurada, permitiendo que otras aplicaciones consuman los datos necesarios para operar.

Hace unas semanas, me encontré con problemas en la integración de una API externa que generaba códigos de barras para facturas en un sistema de cobros de una empresa. Cada actualización o modificación de esta API traía inconvenientes a la hora de realizar los cobros, lo que me llevó a buscar una solución alternativa para evitar problemas inesperados.

Decidí investigar y crear mi propio generador de códigos de barras, de forma que funcionara en mi servidor y no dependiera de servicios de terceros. Así, descubrí la biblioteca PICQER, que permite generar códigos de barras de manera fácil y rápida en PHP.

¿Qué es PICQER?

PICQER es una biblioteca en PHP que facilita la generación de códigos de barras. Es compatible con distintos formatos de códigos y se puede implementar en tu propio servidor, evitando depender de servicios externos.

• Página en Packagist: PICQER en Packagist
• Repositorio en GitHub: PICQER en GitHub

Al probarla, me di cuenta de que los códigos de barras generados son detectados muy rápidamente por los escáneres, lo cual es ideal para aplicaciones que requieren rapidez y precisión.

Ventajas de Usar PICQER

1. Evitas Dependencias Externas: Al levantar el generador en tu servidor, eliminas el riesgo de que un servicio de terceros cause problemas inesperados.
2. Control Total: Puedes personalizar la generación de códigos y su presentación según las necesidades de tu proyecto.
3. Fácil Implementación: La biblioteca es sencilla de usar y viene con ejemplos para facilitar su integración.

Ejemplo de Implementación

Aquí dejo un ejemplo básico de cómo implementar PICQER en PHP para generar un código de barras:

<?php
require 'vendor/autoload.php';

use Picqer\Barcode\BarcodeGeneratorHTML;

$generator = new BarcodeGeneratorHTML();
$barcodeNumber = isset($_GET['number']) ? $_GET['number'] : '1234567891011121314151617181920';

// Generar el código de barras en formato HTML
echo $generator->getBarcode($barcodeNumber, $generator::TYPE_CODE_128);
echo '<p>' . $barcodeNumber . '</p>';
?>

Puedes probar este ejemplo en acción en mi sitio web: Generador de Código de Barras.

Cómo Integrarlo en tu Proyecto

1. Instalación de la Biblioteca PICQER: Utiliza Composer para instalar la biblioteca en tu proyecto:

composer require picqer/php-barcode-generator

2. Configura el Código de Generación: Puedes adaptar el ejemplo anterior para integrarlo en cualquier aplicación PHP.

3. Personalización del Código de Barras: La biblioteca ofrece varias opciones para cambiar el tipo de código de barras (Code 128, EAN, etc.) y ajustar el formato.

Implementar tu propio generador de códigos de barras usando una biblioteca como PICQER es una excelente alternativa para evitar las dependencias de servicios externos que pueden cambiar sin previo aviso. La biblioteca es sencilla de usar y proporciona la flexibilidad necesaria para adaptarse a distintos proyectos.
Mi Bardcode:

https://sergiorios.com.ar/barcode/bardcode.php?number=1234567891011121314151617181920

¡Espero que esto te sea útil! Si tienes alguna experiencia similar o algún comentario, no dudes en compartirlo.

En esta publicación, quiero compartir una funcionalidad que recientemente me tocó agregar en el sitio web a una empresa, y que también he implementado en mi propia web. La idea es integrar la API de WordPress en tu sitio web o portafolio para mostrar las últimas publicaciones de tu blog. Es una funcionalidad interesante que puede añadir valor a tu perfil profesional al mantenerlo actualizado con tu contenido más reciente.

Voy a explicar cómo lo hice utilizando Laravel, un framework de PHP que facilita mucho el desarrollo web. A continuación, les muestro el código que usé para obtener las publicaciones de un blog de WordPress y mostrarlas en la web.

Paso 1: Obtener las Publicaciones del Blog

Primero, creamos una función en Laravel para obtener las publicaciones. La API de WordPress ofrece un endpoint para obtener los posts, que es: https://[URL DE TU BLOG]/wp-json/wp/v2/posts. Vamos a solicitar las últimas 3 publicaciones, pero este número puede ajustarse según tus necesidades.

public function getBlogPosts()
{
    // URL para obtener las publicaciones
    $url = 'https://[URL DE TU BLOG]/wp-json/wp/v2/posts?per_page=3';

    // Hacer la solicitud cURL para obtener las publicaciones
    $posts = $this->makeCurlRequest($url);

    // Si hubo un error en la solicitud
    if (!$posts) {
        return view('index', ['publicaciones' => []]);
    }

    // Arreglo donde guardaremos las publicaciones con las imágenes
    $postsWithImages = [];

    // Recorrer las publicaciones para obtener la imagen destacada
    foreach ($posts as $post) {
        $featuredMediaId = $post['featured_media'];

        // Si la publicación tiene imagen destacada, hacer otra solicitud para obtener los detalles de la imagen
        if ($featuredMediaId) {
            $mediaUrl = "https://[URL DE TU BLOG]/wp-json/wp/v2/media/$featuredMediaId";
            $mediaDetails = $this->makeCurlRequest($mediaUrl);

            if ($mediaDetails && isset($mediaDetails['media_details']['sizes']['full']['source_url'])) {
                $post['featured_image_url'] = $mediaDetails['media_details']['sizes']['full']['source_url'];
            } else {
                $post['featured_image_url'] = null;
            }
        } else {
            $post['featured_image_url'] = null;
        }

        // Agregar la publicación con su imagen al arreglo
        $postsWithImages[] = $post;
    }

    // Pasar las publicaciones con las imágenes a la vista
    return view('index', [
        'publicaciones' => $postsWithImages,
    ]);
}

Paso 2: Configurar la Función makeCurlRequest

Para realizar las solicitudes a la API de WordPress, utilizamos una función llamada makeCurlRequest, que se encarga de hacer la solicitud cURL y devolver los datos obtenidos. Asegúrate de tenerla implementada en tu código:

private function makeCurlRequest($url)
    {
        // Inicializar cURL
        $ch = curl_init();

        // Configurar opciones de cURL
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  

        // Ejecutar la solicitud
        $response = curl_exec($ch);

        // Manejar errores de cURL
        if (curl_errno($ch)) {
            curl_close($ch);
            return false;
        }

        // Cerrar cURL
        curl_close($ch);

        // Decodificar la respuesta JSON
        return json_decode($response, true);
    }

Paso 3: Actualizar la Vista para Mostrar las Publicaciones

Finalmente, debes actualizar la vista para mostrar las publicaciones con los títulos, extractos y, si es posible, las imágenes destacadas. El siguiente código es un ejemplo básico de cómo hacerlo en Blade, la plantilla de Laravel:

<!-- blog dinamico wp -->
        <div class="container py-5">
            <h1 class="text-center mb-4">Últimas Publicaciones de Mi Blog</h1>

            @if(isset($publicaciones) && count($publicaciones) > 0)
                <div class="row">
                    @foreach($publicaciones as $publicacion)
                        <div class="col-md-4 mb-4">
                            <div class="card shadow-sm h-100">
                                <a href="#" target="_blank">
                                    @if (isset($publicacion['featured_image_url']))
                                        <img src="{{ $publicacion['featured_image_url'] }}"
                                            class="card-img-top img-fluid"
                                            alt="Imagen destacada del post"
                                            style="max-height: 200px; object-fit: cover;">
                                    @else
                                        <img src="/ruta/a/imagen/por_defecto.jpg"
                                            class="card-img-top img-fluid"
                                            alt="Imagen por defecto"
                                            style="max-height: 200px; object-fit: cover;">
                                    @endif
                                </a>
                                <div class="card-body">
                                    <h5 class="card-title">
                                        <a href="{{ $publicacion['link'] }}" target="_blank" class="text-dark text-decoration-none">{{ $publicacion['title']['rendered'] }}</a>
                                    </h5>
                                    <p class="card-text">{{ Str::limit(strip_tags($publicacion['excerpt']['rendered']), 150) }}</p>
                                </div>
                                <div class="card-footer bg-transparent text-end">
                                    <a href="{{ $publicacion['link'] }}" class="btn btn-primary btn-sm" target="_blank">Leer más</a>
                                </div>
                            </div>
                        </div>
                    @endforeach

                </div>
            @else
                <p class="text-center">No se encontraron publicaciones.</p>
            @endif
        </div>
        </section>

Consideraciones Adicionales

• Reemplaza [URL DE TU BLOG] por la URL real de tu blog.
• Si las publicaciones no tienen imágenes destacadas, la propiedad featured_media será 0. Puedes manejar este caso mostrando una imagen predeterminada o simplemente omitiendo la imagen.
• Puedes personalizar la cantidad de publicaciones a mostrar cambiando el parámetro per_page en la URL.

Espero que esta guía te sea de utilidad si alguna vez necesitas integrar publicaciones de un blog de WordPress en tu sitio web. ¡No dudes en experimentar con la API de WordPress y adaptarla a tus necesidades!

En esta publicación quiero compartirles mi primera experiencia trabajando con WHMCS y el uso del ORM Eloquent en PHP. Fue un proyecto desafiante pero a la vez muy enriquecedor, ya que me permitió aprender nuevas tecnologías y poner en práctica mis habilidades de desarrollo.

¿Qué es WHMCS?

WHMCS (Web Host Manager Complete Solution) es una plataforma de automatización de facturación y gestión para empresas de hosting. Permite a las empresas gestionar clientes, servicios, facturación, soporte técnico, y más, en un solo lugar. Una de sus principales ventajas es la flexibilidad para personalizar funcionalidades mediante la creación de módulos y extensiones, lo que facilita la integración con otros sistemas o la implementación de características específicas.

¿Qué es el ORM Eloquent?

El ORM (Object-Relational Mapping) Eloquent es una herramienta que forma parte del framework Laravel para trabajar con bases de datos. Facilita la interacción con la base de datos al permitir manipular datos utilizando clases y objetos en lugar de consultas SQL tradicionales. Esto simplifica muchas tareas de desarrollo y hace que el código sea más legible y fácil de mantener.

El Desafío: Desarrollar un Módulo de Retención de Clientes

Mi primera tarea con WHMCS consistió en desarrollar un módulo para la retención de clientes. La idea principal del módulo era ayudar a los operadores a contactar a los clientes que solicitaban la baja de un servicio y ofrecerles un descuento o incentivos para que reconsideraran su decisión.

Características del Módulo:

1. Detección de Solicitudes de Baja: El módulo debía detectar cuando un cliente solicitaba la cancelación de un servicio.
2. Asignación de Operador: Se asignaba un operador para contactar al cliente de forma proactiva.
3. Ofertas de Retención: Se presentaban distintas opciones, como descuentos o mejoras en el servicio, para motivar al cliente a quedarse.
4. Registro de Seguimiento: El módulo registraba las acciones del operador, incluyendo las ofertas realizadas y la respuesta del cliente.

Desarrollo del Módulo con PHP y Eloquent

Al trabajar en este proyecto, utilicé el ORM Eloquent para interactuar con la base de datos de WHMCS. La principal ventaja fue la capacidad de definir modelos y relaciones que facilitaban el acceso a la información de los clientes y sus servicios de manera intuitiva. Fue una experiencia interesante, ya que fue la primera vez que implementaba un ORM en un entorno real, y me permitió ver la potencia de usar Eloquent para escribir código limpio y estructurado.

Retos y Aprendizajes

El principal reto fue familiarizarme con el ecosistema de WHMCS y su estructura de datos. Al ser una plataforma bastante específica para empresas de hosting, su curva de aprendizaje puede ser pronunciada. Sin embargo, trabajar con Eloquent ayudó a simplificar el manejo de la base de datos, lo que hizo que el proceso de desarrollo fuera más fluido.

Resultado Final

El módulo de retención de clientes quedó funcional y permitió mejorar el proceso de atención al cliente, brindando a los operadores una herramienta útil para mantener la relación con los clientes y reducir la tasa de cancelaciones.

Conclusión

Desarrollar mi primer módulo para WHMCS fue una experiencia muy valiosa. Me permitió no solo aprender a trabajar con esta plataforma, sino también mejorar mis habilidades en PHP y en el uso de Eloquent como ORM. Si estás comenzando con WHMCS, te animo a explorar las posibilidades que ofrece la creación de módulos personalizados. Es una excelente manera de aprender y a la vez aportar valor a tu equipo o clientes.