Enthusiast 3.x – Instalación/Configuración
-------------------------------------------
Copyright © Angela Sabas
http://scripts.indisguise.org
Copyright de la traducción al español © Cristina MJ (Calítoe.:.)
http://www.hablandoencristiano.info
===========================================



Enthusiast 3 es una aplicación (script) totalmente personalizable para administrar colecciones de sitios y listados, todo en uno. Es muy diferente de las aplicaciones que se han venido utilizando normalmente para esos fines, así que, por favor, lee entero este archivo para saber cómo instalar, configurar y usar Enthusiast 3 para administrar tu colección de sitios y tus fanlistings.

El uso de Enthusiast 3 consiste principalmente en incluir pedacitos de código PHP en páginas que has construido para tu colectivo (sitio donde reúnes y presentas los sitios web que has construido) y fanlistings. De este modo, ya no se necesitan archivos como joined.php (unidos.php), owned.php (poseidos.php), o affiliates.php (afiliados.php) en el colectivo, o join.php (unirse.php), members.php (miembros.php), update.php (actualizar.php) y otros en los fanlistings.
Se hace aparecer esas secciones por medio de pedacitos de código que se explican más abajo.



CONSEJOS Y TRUCOS IMPORTANTES
------------------------

1. Este archivo instalación.txt intenta explicar en profundidad todo el proceso de instalación, tanto para instalar Enthusiast 3 (el script para el colectivo) como para usar Enthusiast 3 para tus fanlistings o listados similares. ENTHUSIAST 3 ES MUY DIFERENTE DE LOS SCRIPTS HABITUALES, de manera que leer los archivos de texto en su totalidad ES MÁS QUE RECOMENDABLE. En serio, ¡si los lees te ayudarán!

2. Cuando Enthusiast 3 esté instalado y te encuentres en el panel de administración, antes de cambiar nada debes leer todas las instrucciones, consejos y sugerencias que yo haya dejado en la página. Intento proporcionar instrucciones precisas y completas, así que si crees que debería explicar mejor algo, por favor, no dudes en sugerírmelo.

3. Antes de trasladar listados desde PHPFanBase o Enthusiast 2 o antes de usar cualquier otro script de conversión, HAZ COPIAS DE SEGURIDAD DE TUS BASES DE DATOS. Puedes hacer esas copias por medio de PHPMyAdmin o a través del panel de control de tu servicio de alojamiento.

4. Antes de trasladar listados desde PHPFanBase o Enthusiast 2 o antes de usar cualquier otro script de conversión, LEE TODAS LAS INSTRUCCIONES.

5. El cinco es mi número de la suerte, de modo que lo reitero: LEE TODA LA DOCUMENTACIÓN QUE SE PROPORCIONA ANTES DE HACER NADA O DE PREGUNTAR NADA



Instalación principal
-----------------

1. Descomprime el archivo .zip de Enthusiast 3 y abre el archivo enth3/config.php en un editor de textos y cambia las variables de la base de datos para reflejar la información de la base de datos y las tablas que usarás para Enthusiast 3. Por favor, ten en cuenta de que esa será la configuración para tu colectivo (sitio donde presentas tus otros sitios), NO para un fanlisting.

   Fíjate demás en la variable $sendmail. En la mayoría de los casos es ‘/usr/sbin/sendmail’, pero por si acaso compruébalo con tu proveedor de alojamiento web.

2. Copia todos los archivos del directorio (carpeta) enth3 a un directorio en tu sitio web. Ten en cuenta de que este directorio es para la INSTALACIÓN DE ENTH3, NO PARA EL FANLISTING, se trata del directorio para el panel de administración de Enth3.

3. Ve a instalar.php en tu navegador, es decir, si has cargado los archivos de enth3 a http://www.tudominio.com/admin, ve a http://www.tudominio.com/admin/instalar.php

4. Rellena todos los campos del formulario y pulsa “¡Instalar Enthusiast 3!”
Ten en cuenta que LAS BARRAS OBLÍCUAS (/) AL FINAL SON IMPORTANTES. Son MUY importantes para Enth3. La falta de la barra oblicua al final de una ruta o dirección puede provocar muchos errores en el funcionamiento de la aplicación. Conque, por favor, AÑADE BARRAS OBLÍCUAS AL FINA DE TODAS LAS URLs Y RUTAS.
   Optativo: Cuando la instalación se haya completado, puedes identificarte en Enth3 a través de la página index.php o bien instalar las categorías de la red The Fanlistings (y también de modo opcional, las categorías de la red The Anime Fanlistings) por medio del archivo instalar_cats.php
   Recuerda también CHMOD, es decir, modificar los permisos, de los directorios para las imágenes de fanlistings unidos, poseídos y afiliados a 755.

5. Entra en Enth3 a través de index.php ?



Configuración del colectivo
------------------------

1. Abre el archivo config.php que está *fuera* del directorio enth3/ en el archivo zip y complétalo con los valores apropiados para la base de datos. No modifiques nada más.

   Los valores para “sendmail” y para la base de datos en este archivo config.php deben ser exactamente iguales a los del archivo config.php que se encuentra en la instalación de Enth3.
   La única diferencia, de existir alguna, sería el servidor de la base de datos SI el fanlisting está alojado en otro servidor.

2. Sube este archivo al directorio donde quieras que esté el sitio de tu colectivo. Esto no es el panel de administración; el panel de administración y el directorio del colectivo son cosas distintas.

3. Para mostrar los listados a los que te has unido, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestren (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      $show_list = false;
      include $path . 'show_joined.php'; ?>

   Establecer $show_list a “true” mostrará una lista de opciones en lugar de un menú desplegable para seleccionar la categoría.

3. Para mostrar los listados que posees, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestren (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      $status = 'STATUS';
      $hide_dropdown = false;
      $show_list = false;
      $show = 'SHOW';
      include $path . 'show_owned.php'; ?>

   donde STATUS será un valor de los siguientes:

      pending   = para listados pendientes de aprobación por TFL
      upcoming  = para listados que se publicarán en un futuro próximo
      current   = aprobados y publicados

   y SHOW será o bien la ID de la categoría que se verá por defecto si el visitante no elige una en concreto, o bien ‘all’ (todo).
   Las variables $hide_dropdown, , $show_list y $show son totalmente optativas (pueden eliminarse). Establecer $hide_dropdown como “true” no ofrecerá ningún modo de seleccionar una categoría; establecer $show_list como “true” mostrará una lista de opciones para seleccionar la categoría; si se establece un número de ID de una categoría para $show, es categoría será la que se mostrará por defecto.

   Por ejemplo:

   Si simplemente quieres mostrar el menú desplegable en tu página de listados aprobados y publicados con las opciones por defecto, insertas:

      <?php include 'config.php';
      $status = 'current';
      include $path . 'show_owned.php'; ?>

   Pero si, por ejemplo, deseas mostrar los listados que abrirás en un futuro próximo sin el menú desplegable pero quieres que todos los listados futuros aparezcan en cuanto la página se carga (es decir, el usuario no tiene que seleccionar nada), insertas:

      <?php include 'config.php';
      $status = 'upcoming';
      $hide_dropdown = true;
      $show = 'all';
      include $path . 'show_owned.php'; ?>

   Por último, si quieres insertar una lista de opciones pero preseleccionar una categoría que será la primera que verá el usuario, el código que necesitas es:

      <?php include 'config.php';
      $status = 'current';
      $show_list = true;
      $show = '1';
      include $path . 'show_owned.php'; ?>

4. Para mostrar los afiliados del colectivo, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestren (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      include $path . 'show_collective_affiliates.php'; ?>



Estadísticas del colectivo
---------------------

1. Abre con un editor de texto tipo Bloc de Notas la página donde quieres que se muestren las estadísticas de tu colectivo e inserta esta líneas de código justo antes de donde quieras que aparezcan las estadísticas

      <?php
      include 'config.php';
      include $path . 'show_collective_stats.php';
      ?>

2. Las instrucciones a continuación son optativas dependiendo de la clase de información que desees mostrar en tu colectivo. Las líneas de código PHP que siguen mostrarán números a no ser que se especifique lo contrario.

   Sugerencia: si quieres tener que los millares se marquen con comas (sistema anglosajón), puedes usar la siguiente función PHP:

      <?= number_format( $variable ) ?>

   Si quieres mostrar el número total de categorías registradas en tu colectivo (independientemente de si tienes o no en ellas fanlistings a los que te has unido o posees), inserta esta línea en la página:

      <?= $total_cats ?>

   Si quieres mostrar en tu colectivo el número total de listados a los que te has unido (independientemente de si ya te han aprobado o no), inserta esta línea en la página:

      <?= $joined ?>

   Si quieres mostrar en tu colectivo el número total de listados a los que te has unido pero para los que estás pendiente de aprobación, inserta esta línea en la página:

      <?= $joined_pending ?>

   Si quieres mostrar en tu colectivo el número total de listados a los que te has unido y en los que ya estás listado, inserta esta línea en la página:

      <?= $joined_approved ?>

   Si quieres mostrar en tu colectivo el número total de listados que administras (independientemente de su estatus), inserta esta línea en la página:

      <?= $owned ?>

   Si quieres mostrar en tu colectivo el número total de listados que has solicitado administrar pero para los que aún no has recibido notificación, inserta esta línea en la página:

      <?= $owned_pending ?>

   Si quieres mostrar en tu colectivo el número total de listados que administras pero que aún no has publicado, inserta esta línea en la página:

      <?= $owned_upcoming ?>

   Si quieres mostrar en tu colectivo el número total de listados que administras y que ya están aprobados y publicados, inserta esta línea en la página:

      <?= $owned_current ?>

   Si quieres mostrar el número total de enlaces afiliados del colectivo, inserta esta línea en la página:

      <?= $affiliates_collective ?>

   Si quieres mostrar el número total de miembros de tus listados, tanto pendientes como aprobados:

      <?= $collective_total_fans ?>

   Si quieres mostrar el número total de miembros de tus listados, pero sólo los aprobados:

      <?= $collective_total_fans_approved ?>

   Si quieres mostrar el número total de miembros de tus listados, pero sólo los pendientes:

      <?= $collective_total_fans_pending ?>

   Si quieres mostrar la tasa de crecimiento de tus fanlistings, es decir: la tasa que indica el ritmo con el que abres o te aprueban fanlistings.

      <?= $owned_growth_rate ?>

   Si quieres mostrar la tasa de crecimiento acumulativo de tus fanlistings, es decir: el ritmo al que se unen miembros a tus fanlistings.

      <?= $collective_fans_growth_rate ?>

   Si quieres mostrar el ritmo al que te unes a fanlistings:

      <?= $joined_growth_rate ?>

   Si quieres mostrar el fanlisting que administras que has publicado más recientemente, inserta estas líneas en tu página según los detalles que quieras mostrar.

      <?= $owned_newest['title'] ?>       - título del listado
      <?= $owned_newest['subject'] ?>     - tema del listado
      <?= $owned_newest['url'] ?>         - URL del listado
      <?= $owned_newest['desc'] ?>        - descripción del listado
      <?= $owned_newest['listingtype'] ?> - tipo de listado
      <?= $owned_newest['opened'] ?>      - fecha de apertura
      <?= $owned_newest['imagefile'] ?>   - imagen del listado (ruta del directorio no incluida)

   Si quieres mostrar el fanlisting al que te has unido más recientemente (y en cuya lista ya apareces), inserta estas líneas en tu página según los detalles que quieras mostrar.

      <?= $joined_newest['subject'] ?>     - tema del listado
      <?= $joined_newest['url'] ?>         - URL del listado
      <?= $joined_newest['desc'] ?>        - descripción del listado
      <?= $joined_newest['added'] ?>       - fecha en la que te uniste
      <?= $joined_newest['imagefile'] ?>   - imagen del listado (ruta del directorio no incluida)
     
   Si quieres mostrar un fanlisting aleatorio de los que administras y que están publicados, inserta estas líneas en tu página según los detalles que quieras mostrar.

      <?= $owned_random['title'] ?>       - título del listado
      <?= $owned_random['subject'] ?>     - tema del listado
      <?= $owned_random['url'] ?>         - URL del listado
      <?= $owned_random['desc'] ?>        - descripción del listado
      <?= $owned_random['listingtype'] ?> - tipo de listado
      <?= $owned_random['opened'] ?>      - fecha de apertura
      <?= $owned_random['imagefile'] ?>   - imagen del listado (ruta del directorio no incluida)

   Si quieres mostrar un fanlisting aleatorio de aquellos a los que te has unido y en cuya lista ya apareces, inserta estas líneas en tu página según los detalles que quieras mostrar.

      <?= $joined_random['subject'] ?>     - tema del listado
      <?= $joined_random['url'] ?>         - URL del listado
      <?= $joined_random['desc'] ?>        - descripción del listado
      <?= $joined_random['added'] ?>       - fecha en la que te uniste
      <?= $joined_random['imagefile'] ?>   - imagen del listado (ruta del directorio no incluida)



Configuración de fanlistings
------------------------

1. Ve a la página setup.php de tu instalación de Enth3 (puedes llegar hasta ahí a través de la sección "administrados" del panel de control) e instala el fanlisting (sigue las instrucciones en la página).
   Toma nota de la ID del listado que se le asigna tras la creación.

2. Abre el archivo config.php que está *fuera* del directorio enth3/ en el archivo zip y complétalo con los valores apropiados para la base de datos. Retira la marca de comentario (//) de la línea que dice “"$listing = 1;”. Así la línea que antes ponía

      //$listing = 1;

   ahora debe poner

      $listing = 1;

   y cambia el valor de $listing por el de la ID que se le asignó al listado al final del paso 1.

2. Carga este archivo (config.php con la línea $listing SIN COMENTAR) al directorio donde quieras que esté el sitio de tu fanlisting. Este es el directorio del fanlisting. NO el directorio del colectivo y TAMPOCO el directorio del panel de administración. 

   NOTA IMPORTANTE: Las carpetas de tus fanlistings NO TIENEN que estar dentro de la carpeta admin. Pueden estar prácticamente en cualquier parte.

3. Para mostrar la lista de miembros, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      include $path . 'show_sort.php';
      include $path . 'show_members.php'; ?>

   Optativo: al ordenar los miembros bien sea por país o por algún campo adicional, el valor del campo de orden (es decir, para ordenarlos por países, por ejemplo el valor “Guinea Ecuatorial”) desaparecerá de la plantilla de miembros. Por tanto, si tienes a los fans listados como “María de Guinea Ecuatorial”, al ver la lista completa se mostrará la frase como es debido, pero al verlos por país (ver todos los fans de Guinea Ecuatorial en este caso) mostrará solamente “María de”. Para evitarlo, usa estas líneas en su lugar:

      <?php include 'config.php';
      include $path . 'show_sort.php';
      $show_sort_field = true;
      include $path . 'show_members.php'; ?>

   En Enthusiast 3.1, por defecto, se muestran los miembros que se ajustan a los criterios de ordenación que selecciona el visitante, lo cual significa que si el visitante no elige un criterio, la lista mostrará automáticamente TODOS los miembros (paginados, claro). Si tienes seleccionados múltiples criterios de selección (por ejemplo, primero los ordenas por país y luego por orden nombre), cuando el visitante entre por primera vez en la página verá la lista de todos los miembros. Si el visitante decide ordenarlos por país (por ejemplo, de Guinea Ecuatorial), aparecerán los miembros de Guinea Ecuatorial, independientemente de su nombre. Cuando después los ordene otra vez por nombre como “María”, se listarán todos los miembros de Guinea Ecuatorial llamados “María”

   Si deseas deshabilitar esta función (es decir, los visitantes deberán seleccionar opciones de cada nivel de orden antes de que se les presente una lista de miembros), puedes añadir la siguiente línea al código, justo después de incluir el archivo config.php:

      $hide_members_until_final = true;

   Por supuesto, también puedes elegir no ordenar tu lista de miembros, y en tal caso puedes añadir esta línea (¡asegúrate de que $hide_members_until_final no está en el trozo de código!):

      $no_sort = true;

   También es posible separar la lista de opción de orden de la lista de miembros (por ejemplo, si quieres mostrar los países en una lista con viñetas, pero hacerlo de esa manera haría la lista de miembros muy larga, de modo que es mejor poner la lista de países en una página y la lista de miembros en otra). Para hacer esto, crea un nuevo archivo (por ejemplo, paises.php) e inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre la lista de países (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      include $path . 'show_sort.php'; ?>

   Y crea luego otro archivo (por ejemplo, miembros.php) e inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre la lista de países (asegúrate de que la extensión es .php o no funcionará):

      <?php include 'config.php';
      include $path . 'show_members.php'; ?>

   Después de eso, asegúrate de que el valor de la página del listado en el panel de administración de Enth3 para ese fanlisting es miembros.php, NO paises.php.

4. Para mostrar el formulario de inscripción, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre (asegúrate de que la extensión es .php o no funcionará):
      <?php include 'config.php';
      include $path . 'show_join.php'; ?>

5. Para mostrar el formulario de actualización, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre (asegúrate de que la extensión es .php o no funcionará):
      <?php include 'config.php';
      include $path . 'show_update.php'; ?>

6. Para mostrar el formulario de pérdida de contraseña, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestre (asegúrate de que la extensión es .php o no funcionará):
      <?php include 'config.php';
      include $path . 'show_lostpass.php'; ?>

7. Para mostrar las estadísticas del listado, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestren (asegúrate de que la extensión es .php o no funcionará):
      <?php include 'config.php';
      include $path . 'show_stats.php'; ?>

8. Para mostrar los afiliados del listado, inserta las siguientes líneas de PHP en el archivo PHP donde quieres que se muestren (asegúrate de que la extensión es .php o no funcionará):
      <?php include 'config.php';
      include $path . 'show_affiliates.php'; ?>