Tutorial de actualización a Indexhibit 2.0

Hace poco publicaron la versión 2 de Indexhibit. Esto es la traducción de los tutoriales originales en inglés de actualización y de actualización de temas y formatos de exhibición.

Ten en cuenta que en muchos casos es preferible comenzar con una nueva instalación de Indexhibit 2 antes de hacer una actualización de tu vieja instalación. En todo caso léete todo el tutorial antes de empezar con la actualización.

El 4 de Julio se publicó un nuevo proceso de actualización de versiones anteriores a Indexhibit 2 (versión 0.73 o anterior). La nueva herramienta es mucho más segura y no modifica la base de datos existente. Si simplemente quieres actualizar la versión 2 de Indexhibit, léete este tutorial (en inglés).

La buena noticia es que puedes actualizar tu versión anterior de Indexhibit a la nueva versión y mantener tu sitio más o menos como era antes. Sin embargo, cuanto más has personalizado tu sitio, más trabajo necesitarás para completar la actualización con éxito.

Pasos a seguir

La actualización a Indexhibit 2 no es simplemente una traducción de uno a uno, tendrás que completar una serie de pasos que incluyen:

  • Carga del nuevo CMS y actualización de la base de datos
  • Actualización de su tema / CSS
  • Actualización de los formatos de exhibición

Prepararse para la actualización

Haz una copia de seguridad de los archivos de tu sitio. Utiliza una aplicación FTP para copiar todos los archivos de Indexhibit a tu equipo. Debes tener una copia de seguridad de las siguientes carpetas:

/files/
/ndxz-studio/

¡Tienes que hacerlo! Si algo sale mal durante el proceso de actualización el resultado podría ser la pérdida total de tu sitio.

Carga de los archivos nuevos

Nota: Hemos cambiado el nombre de la carpeta /ndxz-estudio a /ndxzstudio (sin el guión). Lo hicimos porque queríamos estar seguros de que los usuarios no podrían perder sus personalizaciones durante la actualización.

Después de haber descargado los archivos de Indexhibit, descomprime la carpeta y sube lo siguiente:

index.php
/ndxzsite/
/ndxzstudio/

Pon las carpetas en el mismo directorio que tu sitio web existente (también conocido como la carpeta “raíz” del servidor) a través de tu aplicación FTP. Si deseas mover tu sitio Indexhibit nuevo a una carpeta diferente (trabajando en ella en privado), puedes hacer esto más adelante.

No subas la carpeta /files/ ya que ya la tienes.

Agrega una carpeta llamada “dimgs” a la carpeta /files/.

Cambia los permisos de las siguientes carpetas a 777 (o 755 si su proveedor lo permite):

/files/dimgs/
/ndxzsite/config/
/ndxzstudio/cache/

Actualización de la base de datos

Dirígete a la siguiente dirección:

http://www.tupáginaweb.com/ndxzstudio/install.php

Seleccione tu idioma y sigue adelante.

La herramienta de actualización trata de encontrar la instalación de Indexhibit anterior y detecta automáticamente la conexión a la base de datos de la instalación anterior. Si deseas utilizar el contenido de tu sitio anterior, debes estar seguro que has seguido las instrucciones anteriores. Si algo no está bien, publica una nota en nuestro foro.

Si tu servidor no esta utilizando PHP5 pueden aparecer algunos mensajes de error – pregunta a tu proveedor si puede actualizar PHP.

Rellena los campos adicionales antes de activar la instalación.

Indexhibit te preguntará si deseas importar el contenido de tu sitio anterior. Simplemente presiona el botón y continuará.

Cuando se haya completado, se te permitirá entrar en el área de preferencias de Indexhibit (el valor predeterminado de usuario / contraseña es index1/exhibit por si acaso). Debes cambiar la información de acceso a algo que puedas recordar fácilmente.

Nota: Indexhibit genera automáticamente páginas de sección para cada sección en tu sitio. Si has estado utilizando las “secciones de la sección” tendrás que hacer ajustes.

Tu sitio web ahora esta actualizado, pero todavía tienes trabajo para actualizar temas/plantillas y formatos de exhibición.

Actualización de temas y formatos de exhibición de Indexhibit 2

Indexhibit 2 tiene capacidades mucho mayores con respecto a versiones anteriores. Por esta razón, habrá algún trabajo requerido para esta actualización. En el futuro, después de la actualización, será mucho más fácil de actualizar y mantener tu sitio web.

Actualización de Temas

Hay una serie de cambios en la sintaxis de las variables de la plantilla y los plugins. Hagamos una lista de los cambios que deben hacerse.

Todos los códigos que hacen referencia a plugins deben ser cambiados:

<plug: ... /> -> <plugin: ... />

Indexhibit tiene una nueva característica que pone en cola las llamadas de CSS y Javascript, por eso que debe cambiar las líneas siguientes en “head” de su plantilla:

<title><last:ndxz_title /> : Indexhibit</title>
<last:page:meta />
<link rel='alternate' type='application/rss+xml' title='RSS' href='http://indexhibit.org/xml/' />
<link rel='stylesheet' href='http://indexhibit.org/ndxzsite/default/reset.css<last:page:version: />' type='text/css' />
<link rel='stylesheet' href='http://indexhibit.org/ndxzsite/default/base.css<last:page:version: />' type='text/css' />
<link rel='stylesheet' href='http://indexhibit.org/ndxzsite/default/style.css<last:page:version />' type='text/css' />
<last:page:css />
<last:page:javascript />
<last:page:onready /><plugin:backgrounder />

Consulte el archivo /ndxzsite/default/index.php para ver todo el HTML de la plantilla de base.

En la misma plantilla tendrá que cambiar:

<plug:front_index /> -> <plugin:index:load_index />
<plug:front_exhibit /> -> <plugin:page:exhibit />

Al final de su plantilla, justo antes de la etiqueta “body” del cierre, debes agregar los siguientes plugins:

<plugin:page:append_page />
<plugin:page:closing />

Nota: si desea quedarse con el viejo “index” (sin todas las características nuevas y debe funcionar con las personalizaciones anteriores del #menú) se puede utilizar el plugin de index alternativo:

Los cambios CSS

El mayor cambio en el CSS implica la estructura básica:

#menu -> #index
#content -> #exhibit

Tendrás que hacer estos actualizaciones a través de su archivo style.css y posiblemente también en los formatos de exhibición.

Por último, asegúrate de que cualquier variable que pueda tener en su Pre o Post Nav en la sección de administración está utilizando las llaves dobles.

Actualización de los formatos de exhibición

Los formatos de exhibición son mucho más potentes ya que aparecerán un montón de posibilidades realmente interesantes con el tiempo. La actualización de ellos no es difícil a menos que hayas hecho un montón de personalizaciones. Este tutorial cubre los conceptos básicos, pero debes consultar en nuestro foro para obtener más información y ayuda. También puedes buscar en los formatos existentes en /ndxzsite/plugin/ para tener una idea de su estructura general.

Nota: estaremos actualizando los formatos comunes y la disponibilidad en nuestra sección de plugins – ¡vuelve pronto para ver si el formato ya ha sido actualizado!

Tienes que mover tus formatos de exhibición de /ndxz-studio/site/plugin/ a /ndxzsite/plugin/ y cambiarles el nombre de exhibit.$format.php a format.$format.php. Si el archivo ya existe entonces ya ha sido actualizado.

Los formatos deben ser identificados por Indexhibit – tienes que poner un poco de información de encabezado en la parte superior del documento poco después de la primera línea:

/*
Format Name: Grow
Format URI: http://www.indexhibit.org/format/grow/
Description: Default Indexhibit format.
Version: 1.0
Author: Indexhibit
Author URI: http://indexhibit.org/
Params: format
Options Builder: default_settings
Source: exhibit
Operands: none
Objects: exhibits
*/

En la parte superior de tu archivo pueden aparecer algunas líneas que podrían parecerse a lo siguiente:

// defaults from the general libary - be sure these are installed
$exhibit['dyn_css'] = dynamicCSS();
$exhibit['lib_js'] = array('grow.vaska.js');
$exhibit['exhibit'] = createExhibit();

La primera línea se puede cambiar, dentro de la función “createExhibit” (abajo) así:

$OBJ->page->exhibit['dyn_css'][] = $this->dynamicCSS();

La segunda línea se cambió de la misma forma a (ten en cuenta que necesitas obtener el nombre del archivo correcto):

$OBJ->page->add_jquery('grow.vaska.js', 26);

Y la tercera línea se elimina simplemente, ya no es necesaria.

Da vuelta a tus funciones en una clase envolviendo todas ellas con:

class Exhibit
{
// all of the existing functions
}

Vuelve a colocar la consulta de imágenes con el siguiente texto:

// get images
$this->imgs = $OBJ->page->get_imgs();

Estamos ofreciendo el viejo formato Grow (conocido como Índice Visual de Indexhibit 2) en el área de plugins para que veas un ejemplo de cómo un formato de exhibición se pueda actualizar.

Mientras que este formato trata de proporcionar la información básica acerca de la actualización de los formatos de exhibición, es probable que no pueda cubrir tu situación. No dudes en informarnos sobre tu situación en nuestro foro.

Tags: , ,

Leave a Reply