Captulo 1.

Interfaz de Trabajo

24

Captulo 1

En este libro aprenderemos DotNetNuke 4.x, es decir, todas las versiones anteriores estn incluidas y sern comentadas, sin embargo existen actualizaciones constantemente, por ello aunque veamos la versin 4.x recomiendo antes visitar la web de DNN (www.dotnetnuke.com). Las nuevas versiones no siempre representan rectificaciones de errores, tambin contienen mejoras o novedades, en este caso, nuevos mdulos, nuevas opciones en los mdulos existentes, etc. Una vez que conocemos el funcionamiento de DNN y la finalidad de su uso, debemos tener claro la temtica y el contenido de la web. Con este punto a tener en cuenta, en este primer captulo empezaremos con algunos conceptos bsicos para poder planificar la creacin de nuestra web. Aquellos lectores que ya disponen de un nivel medio-avanzado en diseo y/o desarrollo web dichos conceptos sern de poco inters, pero espero tengan paciencia ya que son necesarios para todos aquellos lectores que carecen de conocimientos en programacin y diseo web. Antes de empezar debemos disponer del software correctamente instalado en un servidor web, ya sea en Internet o en local, en ambos casos debemos disponer del IIS 6.0 (Internet Information Services) en Windows XP Profesional o IIS 7 en Windows Vista Business o Ultimate y SQL Server, aunque ms adelante veremos otras formas para la ejecucin de DotNetNuke. En este libro aprenderemos cmo instalar paso a paso, DNN en nuestro ordenador con Windows XP y Windows Vista con .NET Framework 2.0 y SQL Server 2005 Express, ya que cada ISP Proveedor de Internet dispone de un software para gestionar el servidor, normalmente Plesk o HELM. En el caso de utilizar IIS 7 sobre Windows Vista es necesario algunos componentes adicionales. En Activar o Desactivar las caractersticas de Windows / Internet Information Services / Herramientas de Administracin Web es necesario disponer del componente Compatibilidad con la Administracin de IIS 6.

Interfaz de Trabajo Preparando la instalacin

25

A continuacin aprenderemos la forma de instalar DNN sobre IIS. Suponiendo que el IIS funciona correctamente, es decir, que en el navegador visualizamos la web http://localhost/localstart.asp, y que disponemos del paquete Install descargado de la web dotnetnuke.com, empezaremos a preparar la instalacin. Para la descarga del software es necesario registrarse, a continuacin accedemos a la pgina Downloads donde encontramos los paquetes Install, Upgrade, Starter Kit y Source, principalmente. En las versiones 4.x disponemos de un asistente a travs del navegador para la correcta instalacin de DNN, pero para ello previamente debemos configurar algunas cosas. Crear la carpeta con los archivos Descomprimimos el paquete de instalacin, ya que viene comprimido en Zip, por ejemplo en C:\Inetpub\wwwroot, dicha ubicacin es la raz del servidor web IIS. A la carpeta le cambiamos el nombre para que no sea tan largo, por ejemplo, DotNetNuke. A continuacin debemos dar permisos de acceso a ASP.NET 2.0 sobre la carpeta creada. Para ello accedemos a las Propiedades de la carpeta con el botn derecho. En la pestaa Seguridad seleccionamos Agregar y en el cuadro inferior de la ventana escribimos ASPNET, seleccionamos Aceptar para confirmar. Comprobaremos que aparece en la lista de usuarios uno denominado ASP.NET Machine Account (Nombre_Pc\Usuario), en la parte inferior de la ventana debemos asignarle permisos, simplemente debemos marcar la casilla de Control total en la columna Permitir y automticamente se marcarn el resto. Podemos volver a desmarcarla y dejar el resto. En Windows Vista debemos utilizar el usuario NETWORK SERVICE en lugar de ASP.NET Machine Account.

26

Captulo 1

Si la pestaa Seguridad no aparece, seleccionamos en el men principal de la ventana, Herramientas > Opciones > Ver, y desmarcamos la casilla, Utilizar uso compartido simple de archivos.

Fig.1.1 y 1.1b - Propiedades de Carpeta en Windows XP y Vista.

Crear/Configurar SQL Server 2005 La configuracin por defecto de DNN asume que usaremos SQL Server 2005 Express con un archivo llamado Database.mdf. Dicho archivo se encuentra ubicado en la carpeta App_Data. Editar el archivo de configuracin Aunque a partir de la versin 4.6.x el propio Asistente enlaza con la base de datos, y por tanto no es necesario editar el archivo de configuracin, veamos el enlace con la base de datos. Una vez que tenemos la base de datos creada debemos indicar a la aplicacin de DNN dnde se encuentra el archivo. Para ello debemos hacerlo en el archivo Web.config en dos sitios, el cual podemos editar con el Bloc de Notas:

Interfaz de Trabajo En debemos tener:

27

En debemos tener:

Como ya he comentado el asistente de instalacin de la versin actual solicita los datos de conexin a la base de datos como veremos ms adelante y por consiguiente no es necesario modificar el archivo web.config manualmente. Configurar el Servidor Web (IIS) Ahora indicaremos al IIS que la carpeta llamada DotNetNuke que se encuentra en su raz es una aplicacin y debe disponer de permisos de ejecucin, adems de otros parmetros. Windows XP Abrimos la consola del IIS a travs de Panel de Control > Rendimiento y mantenimiento > Herramientas administrativas > Administrador de Internet Information Server. Desplegamos el rbol hasta visualizar nuestra carpeta en Sitio web predeterminado. Accedemos a las propiedades de DotNetNuke con el botn derecho sobre la carpeta.

28

Captulo 1

En el campo Nombre de la aplicacin seleccionamos Crear, y en Permisos de ejecucin seleccionamos Sec. Comandos y ejecutables. En la pestaa ASP.NET debemos indicar la versin 2.0.x en el campo Versin de ASP.NET En la pestaa Documentos seleccionamos Agregar e indicamos el nombre Default.aspx. Con las flechas de la izquierda lo situamos en primera posicin o segunda. En la carpeta Documentation existe la carpeta StarterKit en la cual abriendo el archivo Welcome.htm aparece en el navegador toda esta informacin.

Fig.1.2 - Propiedades del Directorio Virtual en IIS.

Windows Vista Abrimos la consola del IIS a travs de Panel de Control > sistema y Mantenimiento > Herramientas administrativas > Administrador de Internet Information Services (IIS).

Interfaz de Trabajo

29

Desplegamos el rbol hasta visualizar nuestra carpeta en Sitio web predeterminado. Abrimos el men contextual de la carpeta DotNetNuke pulsando sobre ella con el botn derecho y seleccionamos Convertir en Aplicacin. El campo Alias representa el nombre con el cual identificaremos la carpeta as como la ubicacin de la carpeta indicada en Ruta de acceso fsica. El campo ms importante es Grupo de aplicaciones en el cual mediante el botn Seleccionar debemos indicar Classic .NET AppPool.

Fig.1.2b - Tipo de aplicacin web en IIS 7.

Seleccionando la carpeta DotNetNuke en el IIS se visualiza la Pgina principal de \DotNetNuke. Accedemos a Documento predeterminado y en Nombres de archivo debe aparecer Default.aspx, entre otros. El orden de los archivos es importante ya que al cargar el sitio web se cargar el primer archivo que encuentre, de este modo si en primer lugar se encuentra por ejemplo index.htm dicha pgina se cargar al abrir la web en lugar de la pgina principal de DNN, Default.aspx. Para confirmar los cambios debemos seleccionar Aplicar situado a la derecha de la ventana.

30

Captulo 1

El Asistente de InstalacinUna vez completados todos los pasos anteriores estamos preparados para ejecutar el asistente de instalacin, para ello simplemente debemos cargar en el navegador la direccin de nuestro Web Server, en este caso http://localhost/DotNetNuke. En la primera pgina del Asistente podemos cambiar el idioma ya que por defecto aparece en Ingls, ms delante tambin veremos cmo instalar nuestro paquete de idioma. En dicha pgina tambin debemos seleccionar la opcin Personalizado, y continuamos seleccionando Siguiente. Es importante tener en cuenta que si cancelamos el Asistente de instalacin en segn qu paso no podremos volver a empezar. Deberemos volver a crear la carpeta con su contenido, dar permisos, etc.

Fig.1.3 - Pgina de inicio del Asistente de Instalacin.

Interfaz de Trabajo

31

Para poder continuar antes debemos comprobar los permisos que hemos establecido a la carpeta que contiene los archivos, para ello seleccionamos Prueba de permisos en la parte inferior. Si todo es correcto nos lo indicar en la parte inferior.

Fig.1.4 - Verificacin de permisos sobre la carpeta con los archivos.

A continuacin procederemos a configurar la conexin con la base de datos. Es la forma grfica de las modificaciones que hemos aprendido antes sobre el archivo Web.config, es decir, indicamos el motor SQL que vamos a utilizar, en nuestro caso SQL Server Express, en el campo Servidor debemos indicar el nombre que tiene nuestro ordenador. En el campo fichero, como bien indica, escribiremos el archivo correspondiente a

32

Captulo 1

la base de datos, DataBase.mdf, y por ltimo marcaremos la Seguridad Integrada ya que la autentificacin se realizar mediante Windows. Para comprobar que la configuracin es correcto y funciona bien seleccionamos Prueba de conexin a la base de datos, si se produce algn error nos aparecer el nmero y descripcin, en caso contrario, Siguiente.

Fig.1.5 - Parmetros de conexin a la base de datos SQL Server.

En el caso de querer utilizar la base de datos un servidor SQL Server, como es el caso de los servidores en Internet, debemos seleccionar en

Interfaz de Trabajo

33

primer lugar Base de datos SQL Server 2000/2005 y a continuacin indicar el nombre del servidor y de la base de datos. Por ltimo es necesario indicar la autenticacin para el servidor SQL, para ello desmarcamos Seguridad integrada e indicamos el Id de usuario y contrasea de acceso. En el siguiente paso del asistente observamos el proceso de ejecucin de los correspondientes scripts. Al finalizar dicho proceso seleccionamos Siguiente.

Fig.1.6 - Pgina que visualiza la ejecucin de las diversas versiones.

Ahora debemos crear el usuario Host, es decir, el nombre de usuario y contrasea que indiquemos a continuacin nos permitir modificar cualquier parte de la web, por lo tanto la contrasea debe ser compleja,

34

Captulo 1

robusta y que cumpla con las caractersticas de seguridad. Como mnimo unos 6 caracteres, que no contengan parte del nombre de usuario, y que est compuesta por maysculas, minsculas y nmeros, incluso en algunos casos se utilizan smbolos (@, # )

>> El nombre de Usuario NO podr volver a modificarse. La contrasea puede cambiarse pero indicando la actual.

Fig.1.7 - Datos correspondientes al Superusuario principal.

Recomiendo anotar estos valores para poder recordarlos fcilmente al principio. Seleccionamos Siguiente para continuar con el asistente.

Interfaz de Trabajo

35

Dependiendo de la versin que hayamos descargado de DotNetNuke aparecern unos mdulos u otros, en esta pgina simplemente debemos marcar aquellos que vayamos a utilizar. En este caso podemos marcarlos todos ya que al trabajar en local no importa mucho el espacio en disco. En el caso de un servidor en Internet debemos controlar ms el espacio en disco. Esta seleccin no es definitiva ya que ms adelante veremos cmo instalar ms mdulos.

Fig.1.8 - Instalacin de los mdulos indicados.

36

Captulo 1

De igual forma, en sucesivos captulos iremos detallando el significado y funcionalidad de cada mdulo. Continuamos seleccionando Siguiente.>> Existen numerosos mdulos gratuitos para DotNetNuke pero tambin existen otros de pago que pueden ser de gran utilidad dependiendo del contenido de la web.

DotNetNuke nos proporciona diversos sistemas de autenticacin a utilizar en nuestro sitio web. En este paso es posible instalar algunos de dichos sistemas ya que otros como LiveID (usado por Live, MSN y Hotmail) y OpenID estn incluidos en la instalacin.

Fig.1.9 - Instalacin de los Servicios de Autenticacin indicados.

A diferencia de otras pginas en esta podemos continuar, Siguiente, o retroceder, Anterior.

Interfaz de Trabajo

37

Al no disponer por el momento de Skins ni paquetes de idioma continuamos con las siguientes pginas seleccionando Siguiente hasta finalizar el asistente.

Fig.1.10 - Instalacin de los Skins indicados.

Como ya hemos visto en la pgina para crear el usuario Host ocurre lo mismo con el usuario Administrador, con la nica diferencia que debemos indicar el Ttulo del portal y la Plantilla a utilizar, inicialmente la de DotNetNuke. La diferencia entre Host y Administrador reside en tema de permisos de edicin sobre el sitio web. El primero tiene control total sobre el sitio y por consiguiente puede crear incluso otros Portales adems de incluir todos los

38

Captulo 1

permisos del Administrador. El segundo tiene permisos para el control del Portal en el que se encuentra. Como veremos en este libro podemos disponer de varios portales con varios Administrador y usuarios independientes para cada Portal con una sola base de datos y un solo dominio.

Fig.1.11 - Datos correspondientes al Administrador principal.

Interfaz de Trabajo

39

Si el asistente finaliza sin incidencias aparecer la pgina de finalizacin de la instalacin en la cual seleccionaremos Proceso finalizado (Ir a la web). Por defecto, DotNetNuke ya dispone de una pgina de inicio configurada que podemos utilizar y modificar o eliminar. Como podemos observar en la parte superior, la cabecera, contiene el logotipo, ms adelante veremos cmo cambiarlo en el caso de que quisiramos este diseo o skin. A continuacin tenemos el men horizontal y el buscador, en la web y en Internet. En el siguiente apartado vemos la fecha actual, la pgina en la cual nos encontramos y las opciones para registrarse y acceder como usuario registrado.

Fig.1.12 - Pgina de inicio por defecto.

40

Captulo 1

En la parte inferior encontramos las notificaciones de Copyright, Trminos de Uso y Privacidad. Por ltimo tenemos la parte central, con la cual trabajaremos, dividida en paneles en las que encontramos los mdulos o recuadros. Aunque ms adelante aprenderemos la operatividad de Idiomas en DotNetNuke veamos antes de empezar cmo cambiar el idioma del portal para que sea ms cmoda su gestin. Podemos obtener el Paquete en Espaol de la web de DotNetNuke accediendo a Resources > Language-Packs. Primer Paso: Paquete de Idioma en Espaol Los paquetes de idiomas vienen contenidos en un archivo Zip, debemos cargar dicho archivo de la siguiente forma: 1.- Accedemos mediante la opcin de Login indicando el usuario y contrasea que hemos establecido en el asistente de configuracin para el Host. 2.- En el men principal (Home) seleccionamos Admin > Languages. 3.- En la parte inferior entramos en Install Language Pack y en la ventana de bsqueda seleccionamos Examinar (este botn aparece en el idioma del sistema operativo). En la ventana de elegir archivo de Windows debemos abrir el archivo Zip que hemos descargado de la web de DotNetNuke. 4.- Seleccionamos de nuevo Install Language Pack. 5.- Aparecen todos los archivos contenidos dentro del archivo comprimido. Volvemos seleccionando Return. 6.- Ahora en Languages aparecen los dos idiomas as como en la barra de bsquedas aparece una lista desplegable con los idiomas.>> Para que no aparezca la lista desplegable con varios idiomas hay que dejar slo uno habilitado.

Interfaz de Trabajo

41

En nuestro caso slo vamos a utilizar el idioma Espaol, por ese motivo veamos cmo activarlo. Seleccionando en la lista desplegable, o la bandera, el idioma cambia automticamente pero al salir y volver a entrar vuelve a estar habilitado el idioma Ingls. Esto ocurre porque el idioma por defecto del Portal es el Ingls, veamos cmo cambiarlo. Accedemos como Admin o Host y seleccionamos Admin > Site Settings. En el apartado Advanced Settings entramos en Other Settings. En Default Language indicamos el idioma Espaol. Al final de la pgina confirmamos los cambios con Update. Como observamos sigue apareciendo la lista desplegable con los dos idiomas, para quitarla volvemos a Admin > Idiomas y al idioma Ingls seleccionamos Deshabilitar.

Instalacin con el Starter KitEn determinados sistemas operativos no disponemos de IIS (Internet Information Services), como es el caso de Windows XP Home y Windows Vista Home Basic/Premium. Desde la misma pgina de descargas de DotNetNuke observamos siempre disponibles 4 archivos: Install, Update, Source y StarterKit. En este caso descargamos el ltimo y observamos en su interior un archivo con extensin .vsi, dicho archivo debemos ejecutarlo con Visual Web Developer Express, el cual podemos obtener gratuitamente en la siguiente direccin: http://www.microsoft.com/spanish/msdn/vstudio/express/default.mspx En dicha direccin actualmente disponemos de las versiones en espaol sin embargo ya est disponible las nuevas versiones 2008 en ingls en: http://www.microsoft.com/express/

42

Captulo 1

Al ejecutar el archivo descargado con extensin .vsi aparece un asistente el cual instalar los objetos necesarios para la ejecucin de DNN . La primera ventana del asistente permite seleccionar aquellos componentes que se desean instalar. Dicho asistente aparece con el idioma del Visual Studio o Visual Web Developer Express.

Fig.1.13 - Seleccin de mdulos para instalar.

Haciendo clic en Next aparece una ventana notificando que no se ha encontrado la Firma y el cdigo que se est instalando puede ser

Interfaz de Trabajo

43

malicioso. Confirmamos que deseamos continuar con la instalacin ya que conocemos su procedencia y compaa que lo ha desarrollado.

A continuacin indica que est preparado para instalar los componentes seleccionados. Seleccionamos Finish para iniciar la instalacin. Por ltimo, visualiza el resultado de la instalacin con un enlace al log de la instalacin de cada componente.

Fig.1.14 - Confirmacin de la instalacin del Starter Kit.

Cerramos el asistente y abrimos el entorno de desarrollo, en este caso Visual Web Developer 2008 Express. Primero debemos cargar el proyecto,

44

Captulo 1

para ello seleccionamos File > Open Web Site (Archivo > Abrir Sitio Web). Buscamos la carpeta que contiene los archivos de DNN (C:\inetpub\wwwroot\DotNetNuke). Antes de agregar cualquier mdulo debemos compilar (Generar) la solucin/proyecto. Para ello seleccionamos Build > Build Web Site (Generar > Generar Sitio Web), si disponemos de la ventana de Resultados en la parte inferior observaremos el proceso y finalmente, si se ha creado correctamente, el siguiente texto:Validation Complete ========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ==========

Finalmente, seleccionamos Debug > Debug Without Debugging (Depurar > Iniciar sin depurar) o Ctrl+F5 y observaremos en el Area de Notificacin de Windows la ejecucin de IIS y el asistente de instalacin de DotNetNuke en el navegador. Si deseamos comprobar la integracin del Starter Kit seleccionamos File > New File (Archivo > Nuevo Archivo) en el men principal. Observamos en la parte inferior de la ventana las plantillas para la creacin de mdulos y skins los cuales aprenderemos una breve introduccin al final de este libro.

Interfaz de Trabajo

45

Fig.1.15 - Plantillas disponibles en Visual Web Developer 2008 Express Edition.

Instalacin con Cassini Web ServerEn el caso de no disponer de IIS existe otra posibilidad para la ejecucin de DNN adems del Starter Kit. Tambin disponemos de otra posibilidad la cual consiste en la utilizacin de un software gratuito que realiza las funciones de servidor web, denominado Cassini Web Server. En primer lugar debemos obtener la tima versin, de UltiDev (ultidev.com), dependiendo de la versin de ASP.NET que vayamos a utilizar, para DotNetNuke 4.x debe ser ASP.NET 2.0. Ejecutamos el asistente de instalacin y seguimos los pasos que nos indica.

46

Captulo 1

Fig.1.16 - Configuracin de Cassini Web Server.

Una vez instalado procedemos a su configuracin la cual es realmente sencilla. Debemos indicar en primer lugar si deseamos utilizar un puerto por defecto o el asignado por el sistema (p.e.1102), el nombre de la aplicacin, una breve descripcin, el ID de la aplicacin seleccionando GENERATE, la ubicacin de la carpeta con los archivos, el nombre del archivo correspondiente a la pgina de inicio (Default.aspx) y la versin de ASP.NET a utilizar, la 2.0. Desmarcar la casilla de Mantener en memoria y guardar los cambios. Al cargar la pgina de principal se iniciar el asistente de instalacin de DotNetNuke ya visto en este captulo.

Interfaz de Trabajo Actualizar DotNetNuke

47

En primer lugar no debemos olvidar realizar una copia de seguridad de la base de datos y del archivo de configuracin web.config. Las actualizaciones se encuentran disponibles en la web de DotNetNuke con el nombre DotNetNuke 4.x.x Upgrade siendo 4.x.x la versin. Dichas actualizaciones consisten en un archivo comprimido Zip el cual debemos descomprimir y copiar todo su contenido a la carpeta de DotNetNuke en el servidor web o C:\Inetpub\wwwroot\Carpeta_de_DNN. El proceso de actualizacin es muy sencillo, copiamos los archivos en el directorio de DotNetNuke e iniciamos la aplicacin abriendo la pgina de inicio en el navegador. Al cargar la pgina de inicio ya se ejecuta la actualizacin por consiguiente no aparecer previamente ninguna pgina inicial de confirmacin, simplemente aparece una nica pgina la cual indica la versin de la Instancia , la versin de la base de datos (las cuales pueden no coincidir si no se realizan cambios importantes en la base de datos) y el estado de la ejecucin de scripts en la base de datos (SQLDataProvider) y actualizaciones de Proveedores instalados, por ejemplo, de Autenticacin como son LiveID y OpenID. Al finalizar, si no se han producido errores, se visualiza el mensaje Upgrade Complete y para continuar hacemos clic sobre el enlace Click Here to Access Your Portal el cual cargar la pgina de inicio del Portal.

48

Captulo 1

Fig.1.17 - Pgina del proceso de actualizacin.