Instalación de ASP-NUKE

Versión Descargada: v2.0.4
Fecha de última modificación: Noviembre 19, 2004

Introducción:

ASP-NUKE es un proyecto para un portal Web libre, corriendo con ASP (VBScript). Es de Código abierto y cualquiera puede usarlo y modificarlo para agregar nuevas características. Por esta razón, nos gustaría saber lo que usted ha hecho y si usted quiere que sea incluido en la próxima versión. Esta versión es la última con todos los últimos parches.

En esta versión usted puede escoger entre dos tipos de bases de datos: "Microsoft Access" o "mySql."

Usted puede encontrar más información sobre el website: ASP-NUKE.

1. Requisitos

Usted debe tener un Servidor Web que pueda ejecutar las páginas ASP para usar el ASP-NUKE, por ejemplo,: IIS5.0 e II4.0, PWS.

Si usted quiere usar la base de datos mySql, debe instalarse en su servidor Web y su proveedor tiene que activarlo para su dominio.

2. Instalación

Después de descomprimir aspnuke204.zip, usted tendrá:

Un directorio llamado "aspnuke" con todos los archivos que pueda necesitar,
un directorio llamado "docs" con otros archivos, tales como:
- el archivo "readme_es.htm" que usted está leyendo actualmente
- El archivo "changes_en.txt" que contiene todas las modificaciones realizadas en esta versión
- El archivo "patches_en.txt" que contiene todo los cambios o correcciones realizadas después de la primera descarga oficial
- La licencia GNU GPL (GPL.txt)

Copie todos los archivos del directorio "aspnuke" en su sitio Web (con un cliente de FTP por ejemplo). Simplemente el contenido de la carpeta, no la propia carpeta del aspnuke.
Usted puede publicar su sitio en la raíz o en una subcarpeta.
No copie el directorio "docs" usted simplemente lo necesitará para documentación.
Si usted eligió usar mySql debe definir las Tablas de la base de datos primero. Para ejecutar las definiciones iniciales, se proporciona el archivo "docs\mySql\crea_tabelle_mySql.sql" que contiene las instrucciones para generar todas las tablas y PRE-cargar los datos iniciales. Para instrucciones de cómo usar este archivo, con mySql, por favor refiérase a las instrucciones de su proveedor y archivos de ayuda (normalmente usted usará una cuenta con "phpMyAdmin" que le permitirá el acceso a la consola del mySql, donde usted tendrá las opciones para correr y ejecutar este archivo). Si usted necesita traducir los datos de las tablas, puede hacerlo revisando este archivo simplemente antes de ejecutarlo contra la base de datos mySql.

Ahora, usted debe ejecutar el archivo setup_es.asp en su Web Server (Ej.: http://www.my-website.com/setup_es.asp si su sitio Web se localiza en http://www.my-website.com) y llenar el formulario para configurar el sitio.
Llene los campos siguientes como sigue:

Nombre del sitio Web: se mostrará en los títulos de la ventana, etc.
El URL del sitio Web: Dirección del sitio Web
ID del administrador: Nombre de usuario para el administrador del sitio
Contraseña del administrador: puede modificarse en el perfil del usuario
Correo electrónico del administrador: debe ser un correo electrónico válido, porque identificará el sistema del webmail disponible
Tipo de la base de datos: si usted escoge mySql, deberá estar ya configurado mysql
Camino o ruta principal de sitio Web: (debe estar vacío si usted instala su sitio en la raíz), o los nombres de los subdirectorios dónde usted ha instalado su sitio: este campo siempre debe empezar con una barra (/), o SÓLO el caracter "/ " si usted instalara su sitio en el directorio raíz

Ahora apriete el botón "Pre-determinado" para llenar todos los otros campos automáticamente, entonces usted puede modificarlos como sigue:

DB principal: el nombre de la base de datos de Access "principal"
Foro DB: el nombre de la base de datos Access para el "foro"
Eventos DB: el nombre de la base de datos Access para el "Calendario Eventos"
Guestbook DB: el nombre de la base de datos Access para el libro de visitas "Guestbook"

Si usted usa mySql, normalmente sólo tiene una base de datos; en este caso todos los campos deben tener un único nombre
Todo los campos siguientes, excepto el "Inicio de sesión" y "Contraseña" siempre debe empezar con el camino especificado en el Camino principal de Sitio Web presente (automáticamente llenado en por el botón de valor Pre-determinado).

Directorio de la base de datos o URL: este campo es una excepción a la regla porque contendrá información diferente que depende del tipo de la base de datos:
- Access: en este caso siga la regla y coloque el camino dónde la base de datos esta cargada
- MySql: en este caso, proporcione el URL (o dirección IP) del servidor de base de datos. Pregunte la información a su proveedor: en la mayoría de los casos usted necesitará sólo especificar el localhost
El directorio de los temas: Coloque el camino dónde el archivo de configuración css está cargado
El Inicio de sesión de DB: sólo usado para la base de datos del mySql, proporcione el nombre de usuario dado por su proveedor
La Contraseña de DB: proporcione la contraseña para acceder la base de datos. Al usar mySql, su proveedor le dirá esta contraseña; al usar Access, usted puede seleccionar una propia y se pondrá automáticamente para todas las bases de datos de Access
Los campos siguientes son auto-explicativos: siempre es un camino dónde un código específico se ha instalado.

Los archivos xml y las bases de datos deben localizarse en carpetas que deben tener permiso de lectura y escritura, usted tiene que especificar su nombre durante la instalación, en cada servidor hay normalmente carpetas usadas para las bases de datos, usted puede poner los archivos allí. Si usted cambiara el camino de este tipo de archivos, al final de la instalación, usted puede borrar las carpetas db y lang (ellos sólo contienen los archivos originales sin configurar).
También las carpetas para subir archivos (Uploads) deben crearse con permisos de lectura y escribiendo incluyendo el archivo dyna_block.asp (usted puede usar la carpeta pública).
¡No se olvide de borrar cualquier archivo setup_xx.asp de su sitio Web para prevenir que otras personas puedan usarlo! El procedimiento de instalación crea una cuenta del admin que tiene los derechos de administrador en el sitio Web. Puede haber sólo un admin principal, pero usted puede agregar a administradores y moderadores para cada sección. Usted también puede cambiar los derechos para permitir a algunos usuarios entrar en la sección del administrador (con los privilegios limitados).

¡Después de esto su sitio estará listo para empezar!

3. Mapa del sitio

Hay 8 carpetas (y otras subcarpetas) en la raíz de su sitio Web:

En la raíz principal usted puede encontrar todas las páginas de los usuarios y del administrador.
La carpeta avatars: contiene todos los "avatares" públicos para los usuarios del foro (usted puede cambiarlo en el archivo de la configuración)
la carpeta databases (sólo si usted el selecciono la base de datos de Access): contiene sus bases de datos (usted puede cambiarlo en el archivo de la configuración). IMPORTANTE: ¡protéjalo contra el acceso desde la red!!! (Configurando IIS, o pregúntele a su administrador del servidor). Si usted no protege esta carpeta, las personas pueden robar su base de datos y tener acceso al sitio Web con derechos de administrador. Esta carpeta debe tener los permisos de lectura y escritura también. Las bases de datos se desarrollan con Access 2000.
la carpeta imgs: contiene todos los recursos gráficos (usted puede cambiarlo en el archivo de la configuración). Contiene que una subcarpeta llamada "noticias" (news) dónde usted puede poner las imágenes de la sección de las noticias.
La carpeta includes: contiene todos los archivos que se incluirán en las paginas principales para su sitio trabaje.
la carpeta public: contiene una subcarpeta llamada "dynblock" que maneja los bloques dinámicos y las otras carpetas para transferir los archivos de los usuarios además de los archivos del "rss" (todas estas carpetas pueden modificarse en el archivo de la configuración) Este tipo de carpeta debe tener permisos de lectura y escritura.
la carpeta smileys: contiene todo el "smileys" que puede usarse en los mensajes, comentarios y foro,... (Usted puede cambiarlo en el archivo de la configuración). <>la carpeta themes: contiene los temas para el sitio (usted puede cambiarlo en el archivo de configuración). El tema predefinido se proporciona con el sitio, usted puede crear y modificar el tema tomando como modelo el predefinido.
la carpeta xml: (por defecto "lang" ) contiene los archivos de XML para la traducción y la configuración dinámica (usted puede cambiarlo en el archivo de la configuración). En esta carpeta usted puede agregar otro archivo de idioma , pero no se olvide también agregar estas versiones en la página de las Versiones en la sección del administrador.

4. Notas

Las opciones del menú en la sección del admin "Editar traducciones" y "Editar configuración", le permite a usted adaptar ASP-NUKE a sus necesidades.
Por defecto, su manejador de correo usa CDOSYS o CDONTS, escogiendo uno automáticamente durante la instalación. Módulos que usan componentes diferentes (como ASPMail o JMail) se liberaran en la sección de descargas del sitio ASP-NUKE oficial.
La conexión de la base de datos es DSN-menos y no permite más de 10 conexión simultáneas a cada base de datos. Para modificar la conexión a la base de datos (para usar DSN), usted debe editar la cadena de conexión en el archivo "/ includes/database-inc.asp." Tenga cuidado en el uso del parámetro "sDBName" para hacer la conexión correcta a la base de datos (hay 3 por defecto).
/ includes/toppage-inc.asp y / includes/bottompage-inc.asp: estos dos archivos construyen la parte de arriba y abajo del sitio como una plantilla. Siéntase libre para adaptarlos a su conveniencia.
/ includes/display-inc.asp: hay algunas funciones de diseño importantes: "CreateTable", "CreateTopTable" y "CreateBottomTable." Usted puede revisarlos si usted quiere otro diseño para los bloques del sitio (se necesita un conocimiento mínimo de ASP y HTML para hacer estas modificaciones).

Si usted no usa el Calendario puede eliminarlo totalmente siguiendo estos pasos:

Borre el enlace desde el menú admin.: haga clic en "Diseño de Bloques" y desactive los "Eventos" en Bloques visibles
Borre cualquier referencia a las rutinas "DisplayCalendar" y "DisplayTopHomeEvents" de todas las páginas (generalmente presentes en la página default.asp)
Borre de la raíz que todos los archivos llamados "calendar_xxx.asp"
Borre la base de datos de Access "calendar.mdb" o "calendar_xxx" de la tabla de la base de datos del mySql
Borre los archivos "calendar_xxx-inc.asp" del directorio "include"
Borre la línea"  " de los archivos "admin_includes-inc.asp", "includes-inc.asp" y "noblocks_includes-inc.asp" en el directorio "include"

Si usted no usa el Foro puede borrarlo totalmente siguiendo estos pasos:

Ponga la variable GLOBAL_FORUM_TOP en 0 (cero) en el archivo de configuración para esconder los enlaces del foro en el menú
Borre de la raíz todos los archivos llamados "forum_xxx.asp"
Borre la base de datos de Access "forum.mdb" o la tabla "forum_xxx" de la base de datos de mySql
Borre los archivos "forum_xxx-inc.asp" del directorio "include"

5. Actualización de una versión anterior

la actualización de la versión 1.2 a 2.0 con la base de datos de Access:

Instale ASP-NUKE 2.0 en una nueva subcarpeta (NO en la misma carpeta dónde está su Aspnuke 1.2)
Reemplace la base de datos de ASP-NUKE 2.0 con las bases de datos de su Aspnuke 1.2
Reemplace el tema de ASP-NUKE 2.0 con el tema de su Aspnuke 1.2
Inicie sesión como administrador
Corra el archivo "admin_updatemain.asp" , modificará la base de datos principal sin modificar sus datos
Corra el archivo "admin_updateforum.asp" , modificará la base de datos del foro sin modificar sus datos
Si usted usaba el "Calendario de Eventos" previamente, también instale la nueva base de datos de Access "calendar.mdb" y copia la base de datos "event.mdb" vieja. Eventualmente, modifique la línea 23 de archivo de "calendar_migratedb-inc.asp" en el directorio "include" (uno con la instrucción Const OLD_DB_EVENTI = "event.mdb"), especificando el nombre de la base de datos de Access si usted la ha modificado (si el nombre todavía es "event.mdb" original, usted puede saltarse este paso). Ejecute la página de "calendar_migratedb.asp" que copiará todos los datos de la vieja a la nueva base de datos, agregando los nuevos campos. Cuando la migración termine con éxito, usted puede borrar la base de datos del calendario vieja.
Ahora usted tendrá un sitio Web ASP-NUKE 2.0 totalmente trabajando, con todos los datos de su sitio Web viejo, salvo los bloques que halla modificado que necesitará adaptar a mano . Información más extendida se publicará en el sitio oficial.

Actualización de la versión 1.2 a 2.0 con la base de datos mySql:

La mejor solución para actualizar su AspNuke 1.2 a AspNuke 2.0 con mySql es actualizar antes de 1.2 a 2.0 con la base de datos de Access como fué explicado en el párrafo anterior.
Después de que la migración ha acabado y después de haber verificado que todo trabaja correctamente sin borrar el archivo "setup_xx.asp", haga los pasos lo siguientes:

Inicie sesión con el usuario y la contraseña de la base de datos del mySql que su proveedor le ha asignado a su sitio
Corra (desde el panel indicado en la documentación de ayuda de su proveedor) el archivo "crea_tabelle_mySql.sql" que reside en la carpeta "docs\mySql": este script creará todas las tablas en su db de mySql, llenándola con los valores predeterminados (usted puede traducir los subtítulos, descripciones, nombres y categorías en este archivo antes de ejecutarlo)
Para cada Tabla de Access (en cada base de datos de Access) cuyos datos deben emigrarse a las Tablas de mySql, siga los pasos siguiente:
- Corra la pagina "importdb.asp" (después que termine bien entre como admin.)
- Especifique el nombre de la tabla que usted quiere emigrar (ej. los usuarios) y selecciona la base de datos de Access (ej. main.mdb)
- Apriete el botón Confirmar
- Este procedimiento crea un archivo, en el mismo directorio de la base de datos, con el mismo nombre de la tabla y una extensión ".SQL". Este archivo contiene todas las declaraciones SQL para cargar la tabla (después de iniciar borre todas las filas existentes)
- Repita este procedimiento para todas las tablas que deben migrarse
Alternativamente, si el procedimiento anterior no trabaja, usted puede seguir estos pasos:
- Corra la pagina "admin_updatedata.asp" (después al finalizar entre como admin.)
- Especifique el nombre de la tabla que usted quiere migrar (ej. los usuarios) y selecciona la base de datos de Access (ej. main.mdb)
- Apriete el botón Confirmar
- Seleccione las líneas que se han generado, cópielos en el Cuaderno (block de notas) y entonces guarde el archivo con un nombre significativo (ej. users.csv)
- Repita este procedimiento para todas las tablas que deben migrarse
Inicie sesión en la consola mySql e importe todos los ficheros de datos en su tabla de mySql correspondientes. Dependiendo de qué procedimiento usted ha usado, siga uno de estos pasos:
- Primero el método (archivos *. el SQL):
  - corra el archivo SQL en una ventana de ejecución SQL desde el manejador de db de mySql, entonces revise al log de errores y verifique que los datos se han cargado bien.
- Segundo método el archivo (*.csv ):
  En este caso, use las utilidades del mySql como debe estar explicado en los archivos de ayuda de su proveedor para importar archivos CSV (pídale ayuda a su administrador de mySql). Usted necesita especificar:
  - el separador de campo: ;
  - Campos delimitados por: '
  - El carácter de escape: \
  - Líneas terminadas por: \r\n
- Después de que la migración ha acabado borre (o renombre) el archivo "configuración-inc.asp" creado en el paso anterior para la base de datos de Access
- Recargue el procedimiento de instalación, cambie el tipo de la base de datos a mySql... ¡y eso es todo!

Si usted guarda durante algunos días las bases de datos de Access, usted puede verificar o comparar que los datos están correctos, es fácil de hacer esto renombrando los dos archivos de configuración generados para las dos bases de datos . Cuando usted esté seguro que todo esta bien, borre la base de datos de Access vieja, el archivo de la configuración y cualquier archivo setup_xx.asp.

6 . Tips (por Eduardo Besembel - besembel@cantv.net)

Para el envio de correo o newsletter tienes que cambiar en el directorio xml en el archivo configuration.xml los valores
<translation name="GLOBAL_SITE_EMAIL">Prueba@prueba.net</translation>
<translation name="GLOBAL_ACCOUNTS_EMAIL">Prueba@prueba.net</translation>
cambiando prueba con la dirección de correo que necesites.
En el archivo original sale la dirección de correo de aspnuke italia.
Si quieres activar o desactivar algunas cosas como el editor web htmlarea, el panel de control, las extenciones que permitiras, etc. en el directorio xml archivo configuration.xml tienes las opciones como ejemplo
Para el editor htmlarea
<translation name="GLOBAL_SITE_WYSIWYG_PATH">/htmlarea/</translation>
<translation name="bWYSIWYGeditor">3</translation>>
tienes que colocar la ruta donde esta el htmlarea en este caso esta en el raiz /htmlarea/ si lo tienes dentro de otro directorio por ejemplo "editor" tendrias que colocar la ruta /editor/htmlarea/ despues activarlo colocando un "3" sin las comillas.
Las imagénes pueden tener solo estas extenciones: <translation name="imgExtensions">*.gif, *.bmp, *.jpg, *.jpeg, *.png</translation>
Si quieres añadir otros tipos de imagenes, tienes que poner le nueva extencion entre los tipos genericos:
<translation name="allowedExtensions">*.txt, *.ace, *.pdf</translation>
y cargarlas por medio de la pagina de Upload.
Otro tip: las categorias no si se me paso algo pero no encontre la forma de ponerlas en español por medio de aspnuke, solamente entrando directamente en la base de datos de access en la tabla typescategories.
Otro tip: Si estas montando Aspnuke en un servidor que tu manipulas asegurate que por medio de la consola mmc de windows donde controlas el servicio IIS los directorios (DB,XML,PUBLIC,PUBLIC/DYNABLOCK,/PUBLIC/UPLOAD,/PUBLIC/UPLOAD/USERS) tengan permiso de lectura y escritura, ademas con el explorador de archivos de windows entra en los directorios xml,db,public/dynablock uno a la ves claro, y seleccionas todos los archivos del directorio con el boton derecho del mouse le das click a esos archivos escoges propiedades seleccionas la pestaña seguridad y asegurate que el usuario "Cuenta de invitado para Internet" tenga permiso de lectura y escritura.
Las categorías del calendario también estan en ingles abres el archivo calendar.mdb y las modificas tiene solo dos tablas, pero por si acaso calendar_eventscat es la que modificarás.

¿Cualquier pregunta, idea o información? Vaya al foro de ASP-NUKE o visite las F.A.Q.

Project starter: Gaëtan Bouveret alias Gat, Webmaster of ASP-Nuke (webmaster@asp-nuke.com).
Traducción realizada por Aspnuke.it staff (webmaster@aspnuke.it) y Eduardo Besembel por español (besembel@cantv.net), Si necesitas información extensa visita www.aspnuke.it

LICENCIA: Este programa es software libre. Usted puede redistribuirlo y/o puede modificarlo según las condiciones de la GNU General Public License publicado por la Fundación del Software Libre; versión 2, o cualquier versión posterior.