El CMS que se adapta a cualquier proyecto
Aunque la mayoría de las distribuciones de Apache vienen con todo lo necesario, en aras de la exhaustividad, aquí hay una lista de los módulos de Apache necesarios:
mod_rewrite
También debe asegurarse de tener AllowOverride All configurado en los bloques y / o para que el archivo .htaccess se procese correctamente y las reglas de reescritura surtan efecto.
La mayoría de los proveedores de alojamiento e incluso las configuraciones locales de LAMP tienen PHP preconfigurado con todo lo que necesita para que Barrio CMS se ejecute.
La version de PHP compatible ahora es minimo 7.4.0.
Si descargó el archivo ZIP y luego planea moverlo a su raíz web, mueva TODA LA CARPETA porque contiene varios archivos ocultos (como .htaccess) que no se seleccionarán de manera predeterminada. La omisión de estos archivos ocultos puede causar problemas al ejecutar Barrio CMS.
└── Raíz/
├── content/
│ ├── blog/ Carpeta del blog
│ ├── documentacion/ Carpeta de la documentación
│ ├── index.md (Pagina inicio)
│ └── 404.md (Pagina error)
├── core/
│ ├── modules/ (Carpeta Extensiones)
│ ├── storage/ (Carpeta datos)
| ├── themes/
│ | └── default/
│ | ├── assets/ (Estilos de la plantilla)
│ | ├── includes/ (Trozos de html)
│ | ├── functions.php (Archivo funciones)
│ | └── index.html (Plantilla html)
│ ├── vendor (clases)
│ └── init.php (Archivo de inicio con definiciones)
├── public (Fotos, videos etc..)/
│ └── notfound.jpg
├── .htaccess
├── 404.html (De uso solo para redirigir)
└── index.php
En el archivo config.php encontraras la configuración de la web, la url del sitio, el titulo, la descripción o la configuración del menu de navegación.
Puedes crear tu propia configuración pero no borres las variables que hay por defecto.
Puedes llamar cualquier variable de config.phpsi estas en el archivo .md con {Config name=nombre}.
<?php include 'includes/head.html';?>
<?php include 'includes/header.html';?>
<main>
<div class="container">
<div class="row">
<div class="col-md-10 m-auto">
<h1 class="divider"><?php echo $page['title'];?></h1>
<h2 class="mb-3 mt-5"><?php echo $page['description'];?></h2>
<?php echo action('theme_before');?>
<?php echo $page['content'];?>
<?php echo action('theme_after');?>
</div>
</div>
</div>
</main>
<?php include 'includes/prefooter.html';?>
<?php include 'includes/footer.html';?>
Las Acciones son funciones que podemos integrar en la plantilla para hacerla mas dináminca. Tenemos unas cuantas por defecto que son:
- head: usada para incluir los estilos.
- theme_before: comentarios tipo discus
- theme_after: resolución de formularios
- footer: Analytics y javascript
Vamos a crear una extensión que automáticamente genere un enlace al final de cada pagina usando una acción que ya esta en la plantilla que es <?php echo action('theme_after');?>.
<?php
// llamamos a la acción theme_after
Action::add('theme_after',function(){
// y ahora que enseñe esto
echo '<a href="'.Barrio::urlBase().'/articulos">Ver articulos.</a>';
});
Y ahora en todas las páginas al final se verá ese enlace, asi de facil.
Ahora vamos añadir algo más, le vamos a decir que si está en la sección artículos y la página extensiones enseñe el texto y si no no enseñe nada.
<?php
// llamamos a la acción theme_after
Action::add('theme_after',function(){
// urlSegment sirve para señalar un segmento del enlace
// si pones var_dump(Barrio::urlSegments()) veras todos los segmentos del enlace
if(Barrio::urlSegment(0) == 'articulos' && Barrio::urlSegment(1) == 'extensiones'){
// y ahora que enseñe esto
echo '<a href="'.Barrio::urlBase().'/articulos">Ver articulos.</a>';
}
});
Ahora haremos una acción que cambie el fondo solo en esta página, para ello usaremos el Barrio::runAction('head') que hay en el archivo head.inc.html.
<?php
// llamamos a la accion head
Action::add('head',function(){
// urlSegment sirve para señalar un segmento del enlace
if(Barrio::urlSegment(0) == 'articulos' && Barrio::urlSegment(1) == 'extensiones'){
// y ahora incrustamos esto
echo '<style rel="stylesheet">
body{
background:blue;
color:white;
}
pre,code{
background: #0000bb;
border-color: #00008e;
box-shadow: 0px 3px 6px -2px #02026f;
color: white;
}
</style>';
}
});
Es muy fácil crear Shortcodes en Barrio CMS por ejemplo, vamos a crear un Shortcode que cambie el color del texto con el color que queramos.
<?php
// llamamos la funcion mejor capitalizada (letra mayúscula)
Shortcode::add('Texto',function($atributos,$contenido){
// extraemos los atributos (en este caso $color)
extract($atributos);
// definimos el color, por defecto sera blue (mejor en ingles)
$color = (isset($color)) ? $color : 'blue';
// parseamos para poder usar markdown
$contenido = Parsedown::instance()->text($contenido);
// aplicamos un filtro para escribir dentro del shortcode
$resultado = Barrio::applyFilter('content','<div style="color:'.$color.'">'.$contenido.'</div>');
// quitamos espacios
$resultado = preg_replace('/\s+/', ' ', $resultado);
// enseñamos la plantilla
return $resultado;
});
Ahora si escribimos [Text color=green] y dentro de este el texto y cerramos con corchetes [/Text] obtenemos esto:
<p style="color:green">Este es un texto dentro de un Shortcode en el que puedo usar **Markdown**</p>
También puedes usar código de color
[Text color='#f00'] // con comillas simples con comillas dobles no funcionara
Hola soy **Rojo**
[/Text]
<p style="color:#f00">Este es un texto dentro de un Shortcode en el que puedo usar
Ahora vamos hacer un Shortcode para incrustar videos de Youtube. En este caso no necesitamos escribir dentro así que es mas facil aun.
<?php
Shortcode::add('Youtube', function ($atributos) {
// extraemos los atributos (en este caso $src)
extract($atributos);
// el codigo del enlace
$id = (isset($id)) ? $id : '';
$clase = (isset($clase)) ? $clase : 'video';
// comprobamos que exista el $id
if($id){
// el html
$html = '<section class="'.$clase.'">';
$html .= '<iframe src="//www.youtube.com/embed/'.$id.'" frameborder="0" allowfullscreen></iframe>';
$html .= '</section>';
$html = preg_replace('/\s+/', ' ', $html);
return $html;
// si no se pone el atributo id que avise
}else{
return Barrio::error('Error [ id ] no encontrado');
}
});
El código seria este:
[Youtube id='GxEc46k46gg']
Con los Shortcodes podemos crear desde galerías, formularios , incrustar videos, Musica, Cambiar el Css y todo un largo etcétera.
Nota: Si tienes instalado Barrio CMS en local puedes probar el editor para ver como funcionan los Shortcodes sino mejor que lo borres por si acaso.