HC - Social Media
Introduction
HC - Social Media (Joomla Module)
HC - Social Media is a modern Joomla module designed to provide a structured, flexible and professional way to manage and display social media links within Joomla websites. It was developed following Joomla 4+ architectural standards, ensuring long-term maintainability, clean separation of responsibilities and compatibility with future platform updates.
This module goes beyond a simple list of links. It is a structured system focused on layout flexibility, per-item customization and clean rendering without compromising performance or code organization.
Architecture and Design Principles
- Clean architecture based on Dispatcher + HelperFactory
- Strict separation between data processing and rendering
- Layout files responsible only for HTML output
- Helper layer responsible for normalization and validation
- Modular CSS separated per layout
- Fail-safe rendering approach
- Structured project organization prepared for future evolution
The module ensures safe updates without breaking changes and maintains consistency across Joomla versions.
Available Layouts
- default – Institutional and balanced presentation
- minimal – Ultra clean and compact display
- inline – Horizontal row with optional separators
- boxed – Clickable card-style blocks
- stacked – Vertical tiles (icon above / text below)
Each layout includes its own dedicated CSS file, keeping visual structure isolated and maintainable.
Per-Item Customization
Each social media item can optionally use individual CSS Variables when customization is enabled.
Supported variables:
- --hc-bg
- --hc-text
- --hc-border
- --hc-bg-hover
- --hc-text-hover
- --hc-border-hover
- --hc-border-width
- --hc-radius
- --hc-py
- --hc-px
- --hc-shadow
- --hc-transition
This approach allows advanced styling control without modifying layout files.
Technical Specifications
- Compatible with Joomla 4.x, 5.x and 6.x
- Compatible with PHP 8.0+
- Joomla Update System ready (Update Server included)
- Dependency Injection architecture
- Parameter normalization layer
- Basic sanitization and validation
- Device visibility control (all / desktop / mobile)
- SVG, image and CSS class icon support
- Clean and maintainable code structure
Roadmap
Planned improvements include:
- Native WhatsApp integration inside the module
- Dedicated phone number and predefined message fields
- Optional highlighted WhatsApp layout
- Accessibility improvements (ARIA refinements)
- Color preset system
- Extended customization options
Author
- https://hirleicarlos.github.io/
- prof.hirleicarlos@gmail.com
HC - Social Media (Módulo Joomla)
Módulo profissional e escalável para gerenciamento de redes sociais no Joomla 4 / 5 / 6.
HC - Social Media é um módulo moderno para Joomla projetado para oferecer uma forma estruturada, flexível e profissional de gerenciar e exibir links de redes sociais em sites Joomla. Foi desenvolvido seguindo os padrões arquiteturais do Joomla 4+, garantindo manutenção de longo prazo, separação clara de responsabilidades e compatibilidade com futuras atualizações da plataforma.
Este módulo vai além de uma simples lista de links. Ele é um sistema estruturado focado em flexibilidade de layout, personalização individual por item e renderização limpa, sem comprometer desempenho ou organização do código.
Arquitetura e Princípios de Projeto
- Arquitetura limpa baseada em Dispatcher + HelperFactory
- Separação rígida entre processamento de dados e renderização
- Arquivos de layout responsáveis apenas pelo HTML
- Camada Helper responsável por normalização e validação
- CSS modular separado por layout
- Estratégia de renderização segura (fail-safe)
- Organização estruturada preparada para evolução futura
O módulo garante atualizações seguras sem breaking changes e mantém consistência entre versões do Joomla.
Layouts Disponíveis
- default – Apresentação institucional e equilibrada
- minimal – Exibição ultra clean e compacta
- inline – Linha horizontal com separadores opcionais
- boxed – Blocos no formato de cards clicáveis
- stacked – Tiles verticais (ícone acima / texto abaixo)
Cada layout possui seu próprio arquivo CSS dedicado, mantendo a estrutura visual isolada e de fácil manutenção.
Personalização por Item
Cada item de rede social pode utilizar CSS Variables individuais quando a customização estiver ativada.
Variáveis suportadas:
- --hc-bg
- --hc-text
- --hc-border
- --hc-bg-hover
- --hc-text-hover
- --hc-border-hover
- --hc-border-width
- --hc-radius
- --hc-py
- --hc-px
- --hc-shadow
- --hc-transition
Essa abordagem permite controle avançado de estilização sem modificar arquivos de layout.
Especificações Técnicas
- Compatível com Joomla 4.x, 5.x e 6.x
- Compatível com PHP 8.0+
- Preparado para Joomla Update System (Servidor de Atualização)
- Arquitetura com Injeção de Dependência
- Camada de normalização de parâmetros
- Sanitização e validação básica
- Controle de exibição por dispositivo (all / desktop / mobile)
- Suporte a SVG, imagem e classes CSS
- Estrutura de código limpa e de fácil manutenção
Roadmap
Melhorias planejadas incluem:
- Integração nativa de WhatsApp dentro do módulo
- Campo dedicado para número e mensagem pré-definida
- Layout opcional com destaque para WhatsApp
- Melhorias de acessibilidade (ARIA)
- Sistema de presets de cores
- Expansão das opções de personalização
Autor
- https://hirleicarlos.github.io/
- prof.hirleicarlos@gmail.com
HC - Social Media
- Version:
- 1.0.0
- Developer:
- Hirlei Carlos Pereira de Araújo
- Last updated:
-
Mar 02 2026
2 months ago - Date added:
- Feb 28 2026
- License:
- GPLv2 or later
- Type:
- Free download
- Includes:
- m
- Compatibility:
- J4 J5 J6
Share