Se agrega algo más a la parte de configuración del Apache.

[z.facultad/75.43/tp1.git] / docs / informe / informe.html

diff --git a/docs/informe/informe.html b/docs/informe/informe.html
index d97a883dee5b07d40999d0666c375b6b5b90aac1..b82a8df9fa56bc0884cfe9cee1781af399803f80 100644 (file)
--- a/docs/informe/informe.html
+++ b/docs/informe/informe.html
@@ -217,21 +217,124 @@
             <img src="faq.desactivarPregunta.jpg"
                 alt="Captura de pantalla de faq.desactivarPregunta.php" />
         </div>
             <img src="faq.desactivarPregunta.jpg"
                 alt="Captura de pantalla de faq.desactivarPregunta.php" />
         </div>

-        <!--
-        
-        COMPLETAR!!!!
-
-        Template:
-
-        <h2>.php</h2>
+        <h2><a name="modulo_info">Modulo de Info</a></h2>
+        <p>
+               El siguiente menu es el que se le presenta al asesor o socio para
+               interactuar con el modulo de info.
+        </p>
+        <div align="center">
+            <img src="info.menu.asesor.jpg"
+                alt="Captura de pantalla de info.menu.asesor.jpg" />
+        </div>

         <p>
         <p>

+               El siguiente menu es el que se le presenta al administrador para
+               interactuar con el modulo de info.
+        </p>
+        <div align="center">
+            <img src="info.menu.administrador.jpg"
+                alt="Captura de pantalla de info.menu.administrador.jpg" />
+        </div>
+        <h2><a name="info_ingresarTemas_php">info.ingresarTemas.php</a></h2>
+        <p>
+               Desde aquí el usuario puede ingresar nuevos temas. (Solo pueden acceder
+               los usuarios administradores)
+               Los campos a completar son:
+                       <strong>Tema</strong>: Nombre del Tema.
+                       <strong>Icono</strong>: Cada Tema tiene un ícono asociado.
+                       <strong>Descripción</strong>: Cada Tema tiene un descripción asociada.
+               Una vez completados se procede a "Guardar Tema".
+               Se mostrará un mensaje indicando si la operación fue exitosa o no.
+               Se mantienen los datos en los campos, y se permite la modificación de lo recien insertado.
+               De retirarse de la página, o presionar sobre "Nuevo Tema" se pierde la posibilidad de modificar.
+        </p>
+        <div align="center">
+            <img src="info.ingresarTemas.php.jpg"
+                alt="Captura de pantalla de info.ingresarTemas.php" />
+        </div>
+        <h2><a name="info_listarTemas_php">info.listarTemas.php</a></h2>
+        <p>
+               Desde aquí el usuario puede ver la lista de temas disponibles para ingresar informaciones.
+               La página se muestra paginada de a 5 temas por vez, se puede acceder a las diferentes
+               páginas navegando el menu superior. (La página actual queda marcada en negrita).
+        </p>
+        <div align="center">
+            <img src="info.listarTemas.php.jpg"
+                alt="Captura de pantalla de info.listarTemas.php" />
+        </div>
+        <h2><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h2>
+        <p>
+               Desde aquí el usuario puede ingresar nuevos informaciones.
+               Los campos a completar son:
+                       <li><strong>Tema</strong>: se debe seleccionar el tema de la lista disponible.</li>
+                       <li><strong>URL</strong>: es la URL hacia la información que se está ingresando.</li>
+                       <li><strong>Comentario</strong>: una breve descripción de la información provista.</li>
+               Una vez completados se procede a "Guardar Información"
+               Se mostrará un mensaje indicando si la operación fue exitosa o no.
+               Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado.
+               De retirarse de la página, o presionar sobre "Nuevo Información" se pierde la posibilidad de modificar.

         </p>
         <div align="center">
         </p>
         <div align="center">

-            <img src=".jpg"
-                alt="Captura de pantalla de .php" />
+            <img src="info.ingresarInfo.php.jpg"
+                alt="Captura de pantalla de info.ingresarInfo.php" />

         </div>
         </div>

-
-        -->
+        <h2><a name="info_listarInfo_php">info.listarInfo.php</a></h2>
+        <p>
+               Desde aquí el usuario puede ver la lista de informaciones disponibles.
+               La página se muestra paginada de a 5 informaciones por vez, se puede acceder a las diferentes
+               páginas navegando el menu superior. (La página actual queda marcada en negrita).
+               Se despliega el icono del tema al cual pertenece, así como la imagen del usuario que cargó
+               dicha información. A continuación se muestra la URL correspondiente, con su comentario.
+               Por último el ranking ( que es la cantidad de accesos que hubo a dicha URL ) y se puede
+               acceder finalmente a la sección de comentarios sobre la información haciendo click en
+               "Ver Comentarios".
+               Esta sección está disponible ordenada por ranking de acceso a la URL, o, eligiendo en "Ver Tema",
+               se listan las informaciones del tema, y luego dentro de ahi las mismas ordenadas por ranking.
+        </p>
+        <div align="center">
+            <img src="info.listarInfo.php.jpg"
+                alt="Captura de pantalla de info.listarInfo.php" />
+        </div>
+        <h2><a name="info_listarComentarios_php">info.listarComentarios.php</a></h2>
+        <p>
+               Esta página es accedida desde "Ver Comentarios" que se encuentra disponible para cada información presente.
+               La misma muestra los comentarios agregados hasta el momento.
+               La página se muestra paginada de a 5 temas por vez, se puede acceder a las diferentes
+               páginas navegando el menu superior. (La página actual queda marcada en negrita).
+               Se presenta el ícono del tema al cual pertenece la información, y por supuesto el comentario en cuestión.
+               Luego se presenta el ícono y apellido del usuario que cargó el comentario (si el usuario que cargó el comentario
+               es el mismo que cargó la información entonces se muestra solamente el apellido), y finalmente se muestra el comentario.
+               Se puede acceder a cargar un nuevo comentario desde "Ingresar Comentario" (esto solo puede ser realizado por los asesores
+               o socios.
+        </p>
+        <div align="center">
+            <img src="info.listarComentarios.php.jpg"
+                alt="Captura de pantalla de info.listarComentarios.php" />
+        </div>
+        <h2><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h2>
+        <p>
+               Desde aquí el usuario puede ingresar nuevos comentarios a informaciones existentes.
+               El campo a completar es:
+                       <li><strong>Comentario</strong></li>
+               Una vez completados se procede a "Guardar Comentario".
+               Se mostrará un mensaje indicando si la operacion fue exitosa o no.
+               Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado.
+               De retirarse de la página, o presionar sobre "Nuevo Comentario" se pierde la posibilidad de modificar.
+        </p>
+        <div align="center">
+            <img src="info.ingresarComentario.php.jpg"
+                alt="Captura de pantalla de info.ingresarComentario.php" />
+        </div>
+        <h2><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h2>
+        <p>
+               En esta pagina se lista el o los usuarios que hayan publicado informaciones con alto ranking.
+               Se suma para cada usuario los rankings de las páginas publicadas, y luego se muestran aquellos que con el
+               ranking mas alto ( se muestra mas de uno cuando el ranking es el mismo para varios usuarios ).
+        </p>
+        <div align="center">
+            <img src="info.mencionEspecial.php.jpg"
+                alt="Captura de pantalla de info.mencionEspecial.php" />
+        </div>
+        

         <h1><a name="desarrollo">Desarrollo</a></h1>
         AGREGAR DESCRIPCION DE LO HECHO!!!!
         <h2><a name="desarrollo_archivos">Formato de Archivos</a></h2>
         <h1><a name="desarrollo">Desarrollo</a></h1>
         AGREGAR DESCRIPCION DE LO HECHO!!!!
         <h2><a name="desarrollo_archivos">Formato de Archivos</a></h2>


@@ -449,6 +552,50 @@
             <li>Id de la pregunta</li>
             <li>Timestamp con la fecha de baja</li>
         </ol>
             <li>Id de la pregunta</li>
             <li>Timestamp con la fecha de baja</li>
         </ol>

+        <h3><a name="temas_csv">temas.csv</a></h3>
+        <p>
+            Este archivo tiene formato <acronym lang="en"
+            title="Comma Separated Values">CSV</acronym>. Se va cargando por los administradores durante
+            la ejecución del sistema.
+            Los campos del archivo son:
+        </p>
+        <ol>
+               <li>ID que identifica unívocamente a los temas.</li>
+            <li>Usuario que cargo el mismo.</li>
+            <li>Nombre del mismo.</li>
+            <li>Ruta al icono del mismo.</li>
+            <li>Breve descripción.</li>
+            <li>Fecha de alta/modificación.</li>
+        </ol>
+        <h3><a name="infos_csv">infos.csv</a></h3>
+        <p>
+            Este archivo tiene formato <acronym lang="en"
+            title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
+            la ejecución del sistema.
+            Los campos del archivo son:
+        </p>
+        <ol>
+               <li>ID que identifica univocamente a las informaciones.</li>:
+            <li>ID del tema al cual pertenece.</li>
+            <li>URL (link) a la información otorgada.</li>
+            <li>Usuario que cargo el mismo.</li>
+            <li>Breve descripción.</li>
+            <li>Cantidad de visitas a la URL (link) proporcionada.</li>
+            <li>Fecha de alta/modificación.</li>
+        </ol>
+        <h3><a name="comentarios_csv">comentarios.*.csv</a></h3>
+        <p>
+            Este archivo tiene formato <acronym lang="en"
+            title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
+            la ejecución del sistema.
+            Los campos del archivo son:
+        </p>
+        <ol>
+               <li>ID que identifica univocamente a las informaciones.</li>
+            <li>Usuario que cargó el mismo.</li>
+            <li>Comentario.</li>
+            <li>Fecha de alta/modificación.</li>
+        </ol>

         <h1><a name="herramientas">Herramientas de desarrollo</a></h1>
         <p>
             Cada integrante eligió herramientas de desarrollo propias, más allá
         <h1><a name="herramientas">Herramientas de desarrollo</a></h1>
         <p>
             Cada integrante eligió herramientas de desarrollo propias, más allá


@@ -484,30 +631,61 @@
         <h2>Sebastián Arena</h2>
         <dl>
             <dt>Navegador</dt>
         <h2>Sebastián Arena</h2>
         <dl>
             <dt>Navegador</dt>

-            <dd><p></p></dd>
+            <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>

             <dt>Editor de texto</dt>
             <dt>Editor de texto</dt>

-            <dd><p></p></dd>
+            <dd><p>EmEditor</p></dd>

             <dt>Validador</dt>
             <dt>Validador</dt>

-            <dd><p></p></dd>
+            <dd><p>Herramientas de w3c: tidy y el servicio de validación
+                online (http://validator.w3.org/)</p></dd>

             <dt>Herramientas de diseño de HTML</dt>
             <dd><p></p></dd>
         </dl>
         <h1><a name="configuracion">Configuración del servidor</a></h1>
         <p>
             <dt>Herramientas de diseño de HTML</dt>
             <dd><p></p></dd>
         </dl>
         <h1><a name="configuracion">Configuración del servidor</a></h1>
         <p>

-            COMPLETAR!!! Por ahora nada, sólo que ande PHP.
+            El servidor no debe ser configurado de ninguna forma en particular,
+            sólo debe tener activado el módulo de PHP y la extensión user_dir de
+            apache si va a ser instalado en el directorio public_html de un
+            usuario. El resto de las configuración se realizan desde el mismo
+            sistema, por lo que no es necesario hacer modificaciones ni a la
+            configuración del apache ni a la del PHP.
+        </p>
+        <p>
+            Si no estuviera configurado el módulo user_dir, habría que agregar
+            al apache las siguiente líneas:
+            <pre>
+LoadModule userdir_module libexec/mod_userdir.so
+AddModule mod_userdir.c
+UserDir public_html
+            </pre>
+        </p>
+        <p>
+            Si no estuviera configurado el módulo de php, habría que agregar
+            al apache las siguiente líneas:
+            <pre>
+LoadModule php4_module libexec/libphp4.so
+AddModule mod_php4.c
+AddType application/x-httpd-php .php
+            </pre>
+            El archivo php.ini no necesita modificaciones a los valores por
+            omisión que trae cuando se instala.

         </p>
         <h1><a name="instalación">Instalación</a></h1>
         <p>
         </p>
         <h1><a name="instalación">Instalación</a></h1>
         <p>

-            COMPLETAR!!! Supongo que es suficiente con copiar los archivos de
-            src/ al public_html, ponerle permisos de lectura para el apache en
-            todo y permisos de escritura en el directorio data/ y fotos/.
+            Sólo debe ejecutar el script ./install.sh que se encuentra en el
+            disquette. El script crea el directorio public_html en el directorio
+            del usuario actual (si no existiese) y copia los archivos
+            necesarios, con los permisos pertinentes para que el apache pueda
+            leer o escribir según corresponda. Una vez instalado, el sistema se
+            puede acceder en
+            <a href="http://localhost/~sisdis10/">http://localhost/~sisdis10/</a>
+            (si se instala con el usuario sisdis10, por supuesto).

         </p>
         <h1><a name="uso">Modo de uso</a></h1>
         <p>
             COMPLETAR!!! Mucho de esto por ahora está en la descripción del
         </p>
         <h1><a name="uso">Modo de uso</a></h1>
         <p>
             COMPLETAR!!! Mucho de esto por ahora está en la descripción del

-            diseño...
+            diseño... Habría que hacer una descripción de un circuito completo
+            que vaya por toas las páginas...

         </p>
     </body>
 </html>
         </p>
     </body>
 </html>

-
-<!-- vim: set et sw=4 sts=4 : -->
+<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file