108 lines
3.3 KiB
Markdown
108 lines
3.3 KiB
Markdown
|
# Bloques en Transición
|
||
|
|
|
||
|
|
Plugin de WordPress para gestionar el contenido del microsite "Bloques en Transición" de Tangente.coop.
|
||
|
|
|
||
|
|
## Descripción
|
||
|
|
|
||
|
|
Este plugin crea los tipos de contenido personalizados, taxonomías y campos ACF necesarios para el microsite de Bloques en Transición.
|
||
|
|
|
||
|
|
## Características
|
||
|
|
|
||
|
|
### Tipos de Contenido (CPTs)
|
||
|
|
|
||
|
|
- **Actuaciones** (`actuacion`): Proyectos y acciones del programa
|
||
|
|
- **Recursos** (`recurso_bloques`): Documentos, guías e informes
|
||
|
|
- **Eventos** (`evento_bloques`): Actividades y formaciones
|
||
|
|
|
||
|
|
### Taxonomías
|
||
|
|
|
||
|
|
- **Iniciativas**: Oficina de Transición Justa, Coles en transición, Comunidad energética, Creación de redes
|
||
|
|
- **Líneas de Trabajo**: Energía, Cuidados, Alimentación, Movilidad, Renaturalización, Reutilización
|
||
|
|
- **Tipos de Evento**: Online, Presencial
|
||
|
|
|
||
|
|
### Campos ACF
|
||
|
|
|
||
|
|
El plugin registra automáticamente los campos ACF necesarios para cada tipo de contenido:
|
||
|
|
|
||
|
|
- **Actuaciones**: Es piloto, Dirección, Localidad, Latitud, Longitud
|
||
|
|
- **Recursos**: Archivo, Tipo de recurso, URL externa
|
||
|
|
- **Eventos**: Fecha inicio/fin, Hora inicio/fin, Lugar, Dirección, URL online, URL inscripción
|
||
|
|
|
||
|
|
## Instalación
|
||
|
|
|
||
|
|
1. Sube la carpeta `bloques-transicion` a `/wp-content/plugins/`
|
||
|
|
2. Activa el plugin desde el panel de WordPress
|
||
|
|
3. Ve a **Bloques > Cargar datos** para crear las categorías iniciales
|
||
|
|
|
||
|
|
## Requisitos
|
||
|
|
|
||
|
|
- WordPress 6.0+
|
||
|
|
- PHP 8.0+
|
||
|
|
- Plugin ACF (Advanced Custom Fields) instalado y activo
|
||
|
|
|
||
|
|
## Uso
|
||
|
|
|
||
|
|
### Shortcodes disponibles
|
||
|
|
|
||
|
|
```
|
||
|
|
[bloques-listado type="actuaciones" widget="grid" columns="3"]
|
||
|
|
[bloques-listado type="recursos" filter="true"]
|
||
|
|
[bloques-eventos limit="5" upcoming="true"]
|
||
|
|
[bloques-iniciativas columns="4"]
|
||
|
|
[bloques-lineas columns="6"]
|
||
|
|
```
|
||
|
|
|
||
|
|
### Atributos del shortcode principal
|
||
|
|
|
||
|
|
| Atributo | Valores | Por defecto | Descripción |
|
||
|
|
|----------|---------|-------------|-------------|
|
||
|
|
| `type` | actuaciones, recursos, eventos | actuaciones | Tipo de contenido |
|
||
|
|
| `widget` | grid, list | grid | Modo de visualización |
|
||
|
|
| `columns` | 1, 2, 3, 4 | 3 | Número de columnas |
|
||
|
|
| `pagination` | 0, 5, 10, 15, 20 | 0 | Items por página (0 = sin paginación) |
|
||
|
|
| `filter` | true, false | false | Mostrar filtros |
|
||
|
|
| `iniciativa` | slug | - | Filtrar por iniciativa |
|
||
|
|
| `linea` | slug | - | Filtrar por línea de trabajo |
|
||
|
|
| `limit` | número | -1 | Límite de items |
|
||
|
|
| `orderby` | date, title, menu_order | date | Ordenar por |
|
||
|
|
| `order` | ASC, DESC | DESC | Dirección del orden |
|
||
|
|
|
||
|
|
## Personalización de estilos
|
||
|
|
|
||
|
|
El plugin incluye estilos base que puedes personalizar desde tu theme usando las siguientes variables CSS:
|
||
|
|
|
||
|
|
```css
|
||
|
|
:root {
|
||
|
|
--bloques-primary: #1E6B52;
|
||
|
|
--bloques-secondary: #2A9D8F;
|
||
|
|
--bloques-accent: #F4A261;
|
||
|
|
--bloques-text: #333;
|
||
|
|
--bloques-text-light: #666;
|
||
|
|
--bloques-bg: #f8f9fa;
|
||
|
|
--bloques-radius: 8px;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Clases CSS principales
|
||
|
|
|
||
|
|
- `.bloques-listado` - Contenedor principal
|
||
|
|
- `.bloques-items` - Grid de items
|
||
|
|
- `.bloques-item` - Item individual
|
||
|
|
- `.bloques-item-thumbnail` - Imagen del item
|
||
|
|
- `.bloques-item-content` - Contenido del item
|
||
|
|
- `.bloques-tag` - Etiquetas de taxonomía
|
||
|
|
- `.bloques-btn` - Botones
|
||
|
|
- `.bloques-filter-bar` - Barra de filtros
|
||
|
|
|
||
|
|
## Integración con Divi
|
||
|
|
|
||
|
|
El plugin es compatible con Divi Theme Builder. Puedes usar los shortcodes en cualquier módulo de código o texto.
|
||
|
|
|
||
|
|
## Soporte
|
||
|
|
|
||
|
|
Plugin desarrollado por [Freepress Coop](https://freepress.coop)
|
||
|
|
|
||
|
|
## Licencia
|
||
|
|
|
||
|
|
GPL-2.0+
|