]> git.llucax.com Git - z.facultad/75.43/tp1.git/blobdiff - docs/informe/informe.html
Modificacion para el punto H de mi parte
[z.facultad/75.43/tp1.git] / docs / informe / informe.html
index b82a8df9fa56bc0884cfe9cee1781af399803f80..0257901410a3862b1733cd1941ac6f18a4afae90 100644 (file)
@@ -32,8 +32,8 @@
             </tr>
             <tr>
                 <td>Sebastián Arena</td>
-                <td>COMPLETAR</td>
-                <td>COMPLETAR</td>
+                <td>80367</td>
+                <td>Actualización de información de interés de otros sitios y comentarios</td>
             </tr>
         </table>
         <h1>Índice</h1>
             <li><a href="#desarrollo">Desarrollo</a></li>
             <li><a href="#herramientas">Herramientas de desarrollo</a></li>
             <li><a href="#configuracion">Configuración del servidor</a></li>
-            <li><a href="#instalación">Instalación</a></li>
+            <li><a href="#instalacion">Instalación</a></li>
             <li><a href="#uso">Modo de uso</a></li>
         </ol>
         <h1><a name="disenio">Diseño de las páginas</a></h1>
-        <h2><a name="index_php">index.php</a></h2>
+        <h2><a name="modulo_admin">Modulo de Administración</a></h2>
+        <h3><a name="index_php">index.php</a></h3>
         <p>
             Esta página es el punto de partida del sistema. Normalmente se
             encarga de mostrar el <a href="#admin_login_php"><span
@@ -58,7 +59,7 @@
             se usa el sistema y todavía no hay 2 administradores asignados;
             respectivamente).
         </p>
-        <h2><a name="admin_login_php">admin.login.php</a></h2>
+        <h3><a name="admin_login_php">admin.login.php</a></h3>
         <p>
             Es la página que realmente se encarga de hacer el
             <span lang="en">login</span>. Debe ingresarse el código de usuario
@@ -70,7 +71,7 @@
             <img src="admin.login.jpg"
                 alt="Captura de pantalla de admin.login.php" />
         </div>
-        <h2><a name="admin_logout_php">admin.logout.php</a></h2>
+        <h3><a name="admin_logout_php">admin.logout.php</a></h3>
         <p>
             Esta página, al igual que <a href="#index_php">index.php</a>, no
             tiene contenido propio, sino que se encarga de borrar todos los
@@ -80,7 +81,7 @@
             Si el usuario no existe, o si está mal el password, etc, se muestra
             el correspondiente mensaje de error.
         </p>
-        <h2><a name="admin_asociarse_php">admin.asociarse.php</a></h2>
+        <h3><a name="admin_asociarse_php">admin.asociarse.php</a></h3>
         <p>
             Esta página asocia a un integrante del grupo (presente en el archivo
             int_2005.txt si es socio o ase_2005.txt si es asesor). Si el sistema
@@ -95,7 +96,7 @@
             <img src="admin.asociarse.jpg"
                 alt="Captura de pantalla de admin.asociarse.php" />
         </div>
-        <h2><a name="admin_log_php">admin.log.php</a></h2>
+        <h3><a name="admin_log_php">admin.log.php</a></h3>
         <p>
             Esta página muestra el <span lang="en">log</span> de actividades del
             usuario. Permite elegir la fecha desde la cual se quieren ver las
             <img src="admin.log.jpg"
                 alt="Captura de pantalla de admin.log.php" />
         </div>
-        <h2><a name="admin_creditos_php">admin.creditos.php</a></h2>
+        <h3><a name="admin_creditos_php">admin.creditos.php</a></h3>
         <p>
             En esta página el administrador puede agregar créditos a los
             usuarios. Para realizar esta tarea el administrador debe ingresar su
             <img src="admin.creditos.jpg"
                 alt="Captura de pantalla de admin.creditos.php" />
         </div>
-        <h2><a name="admin_admin_php">admin.admin.php</a></h2>
+        <h3><a name="admin_admin_php">admin.admin.php</a></h3>
         <p>
             A través de esta página un administrador puede <em>ceder</em> sus
             permisos de administración. Una vez cedidos, este usuario dejará de
             <img src="admin.admin.jpg"
                 alt="Captura de pantalla de admin.admin.php" />
         </div>
-                               <h2><a name="faq_listarPreguntas_php">faq.listarPreguntas.php</a></h2>
+        <h2><a name="modulo_faqs">Modulo de FAQs</a></h2>
+                               <h3><a name="faq_listarPreguntas_php">faq.listarPreguntas.php</a></h3>
         <p>
             Esta página lista las preguntas ingresadas en el sistema. Para cada
                                                pregunta, se muestra la fecha de creación, el nombre de autor, con su 
             <img src="faq.listarPreguntas.jpg"
                 alt="Captura de pantalla de faq.listarPreguntas.php" />
         </div>
-                               <h2><a name="faq_listarRespuestas_php">faq.listarRespuestas.php</a></h2>
+                               <h3><a name="faq_listarRespuestas_php">faq.listarRespuestas.php</a></h3>
         <p>
             El listador de respuestas muestra ordenadas por ranking las respuestas a una 
                                                pregunta seleccionada. Utiliza el paginador, al igual que el listador de preguntas, 
             <img src="faq.listarRespuestas.jpg"
                 alt="Captura de pantalla de faq.listarRespuestas.php" />
         </div>
-                               <h2><a name="faq_ingresarPregunta_php">faq.ingresarPregunta.php</a></h2>
+                               <h3><a name="faq_ingresarPregunta_php">faq.ingresarPregunta.php</a></h3>
         <p>
             Desde el menú de la aplicación se puede acceder a esta página. En caso de que el 
                                                usuario logueado tenga los créditos para hacerlo, podrá formular una pregunta que 
             <img src="faq.ingresarPregunta.jpg"
                 alt="Captura de pantalla de faq.ingresarPregunta.php" />
         </div>
-                               <h2><a name="faq_responderPregunta_php">faq.responderPregunta.php</a></h2>
+                               <h3><a name="faq_responderPregunta_php">faq.responderPregunta.php</a></h3>
         <p>
             Desde el listado de preguntas se puede acceder a la pantalla que permite responder 
                                                la pregunta. La misma muestra en el encabezado la pregunta que se esta respondiendo. 
             <img src="faq.responderPregunta.jpg"
                 alt="Captura de pantalla de faq.responderPregunta.php" />
         </div>
-                               <h2><a name="faq_calificarRespuesta_php">faq.calificarRespuesta.php</a></h2>
+                               <h3><a name="faq_calificarRespuesta_php">faq.calificarRespuesta.php</a></h3>
         <p>
             La pantalla de calificación de respuesta solo puede ser accedida por el autor de
                                                la pregunta que tiene dicho ítem como respuesta. En esta pantalla, desde un combo, se
             <img src="faq.calificarRespuesta.jpg"
                 alt="Captura de pantalla de faq.calificarRespuesta.php" />
         </div>
-                               <h2><a name="faq_desactivarPregunta_php">faq.desactivarPregunta.php</a></h2>
+                               <h3><a name="faq_desactivarPregunta_php">faq.desactivarPregunta.php</a></h3>
         <p>
                                         Desde esta pantalla, los administradores pueden dar de baja una pregunta. De todas formas la pregunta
                                         seguirá existiendo, con sus respuestas, pero no sera mostrada mas por el listador. Para acceder a la pantalla
                 alt="Captura de pantalla de faq.desactivarPregunta.php" />
         </div>
         <h2><a name="modulo_info">Modulo de Info</a></h2>
+        <h3><a name="info_ingresarTemas_php">info.ingresarTemas.php</a></h3>
         <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>
-               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.
+               Permite al usuario el ingreso/modificación de nuevos Temas.
         </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>
+        <h3><a name="info_listarTemas_php">info.listarTemas.php</a></h3>
         <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).
+               Permite ver la lista de temas disponibles para ingresar informaciones.
         </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>
+        <h3><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h3>
         <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.
+               Permite al usuario ingresar nuevas informaciones a los temas actuales.
         </p>
         <div align="center">
             <img src="info.ingresarInfo.php.jpg"
                 alt="Captura de pantalla de info.ingresarInfo.php" />
         </div>
-        <h2><a name="info_listarInfo_php">info.listarInfo.php</a></h2>
+        <h3><a name="info_listarInfo_php">info.listarInfo.php</a></h3>
         <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.
+               Permite al usuario puede ver la lista de informaciones disponibles ordenadas por ranking,
+               o por tema y 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>
+        <h3><a name="info_listarComentarios_php">info.listarComentarios.php</a></h3>
         <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.
+               Permite ver los comentarios agregados hasta el momento.
         </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>
+        <h3><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h3>
         <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.
+               Permite al usuario ingresar nuevos comentarios a informaciones existentes.
         </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>
+        <h3><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h3>
         <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 ).
+               Permite ver la lista de el o los usuarios que hayan publicado informaciones con alto ranking.
         </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>
         <p>
             Todos los archivos del sistema se almacenan en el directorio data.
             Los campos del archivo son:
         </p>
         <ol>
-               <li>ID que identifica unívocamente a los temas.</li>
+            <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>
             Los campos del archivo son:
         </p>
         <ol>
-               <li>ID que identifica univocamente a las informaciones.</li>:
+                   <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>
             <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>
+            <dd><p>Ninguna</p></dd>
         </dl>
         <h1><a name="configuracion">Configuración del servidor</a></h1>
         <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>
+        <pre>
+                       LoadModule userdir_module libexec/mod_userdir.so
+                       AddModule mod_userdir.c
+                       UserDir public_html
+        </pre>
         <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>
+        </p>
+        <pre>
+                       LoadModule php4_module libexec/libphp4.so
+                       AddModule mod_php4.c
+                       AddType application/x-httpd-php .php
+        </pre>
+        <p>
             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>
+        <h1><a name="instalacion">Instalación</a></h1>
         <p>
             Sólo debe ejecutar el script ./install.sh que se encuentra en el
             disquette. El script crea el directorio public_html en el directorio
@@ -681,11 +624,114 @@ AddType application/x-httpd-php .php
             (si se instala con el usuario sisdis10, por supuesto).
         </p>
         <h1><a name="uso">Modo de uso</a></h1>
+        <h2><a name="uso_modulo_admin">Modulo de Administración</a></h2>
         <p>
-            COMPLETAR!!! Mucho de esto por ahora está en la descripción del
-            diseño... Habría que hacer una descripción de un circuito completo
-            que vaya por toas las páginas...
+               COMPLETAR!
+        </p>
+        <h2><a name="uso_modulo_faqs">Modulo de FAQs</a></h2>
+               <p>
+               COMPLETAR!
+        </p>
+        <h2><a name="uso_modulo_info">Modulo de Info</a></h2>
+        <p>
+               El modulo de info permite el ingreso de temas, informaciones y comentarios,
+               y para la interaccion con el mismo se definieron distintos menúes en base
+               a los roles presentes en la plataforma.
+               El siguiente menu es el que se le presenta al asesor o socio.
+        </p>
+        <div align="center">
+            <img src="info.menu.asesor.jpg"
+                alt="Captura de pantalla de info.menu.asesor.jpg" />
+        </div>
+        <p>
+               El siguiente menu es el que se le presenta al administrador.
+        </p>
+        <div align="center">
+            <img src="info.menu.administrador.jpg"
+                alt="Captura de pantalla de info.menu.administrador.jpg" />
+        </div>
+        <p>
+               Desde <a href="#info_ingresarTemas_php">info.ingresarTemas.php</a> el usuario puede ingresar nuevos temas.
+               (Solo pueden acceder los usuarios administradores).<br />Los campos a completar son:
+               </p>
+               <ul>
+               <li><strong>Tema</strong>: Nombre del Tema.</li>
+               <li><strong>Icono</strong>: Cada Tema tiene un ícono asociado.</li>
+               <li><strong>Descripción</strong>: Cada Tema tiene un descripción asociada.</li>
+               </ul>
+               <p>
+               Una vez completados se procede a "Guardar Tema".<br />
+               Se mostrará un mensaje indicando si la operación fue exitosa o no.
+               En cualquiera de los dos casos se mantienen los datos en los campos, y se 
+               permite la modificación de lo recien insertado, a modo de correccion de posibles errores 
+               del usuario al tipear.<br />De retirarse de la página,  o presionar sobre "Nuevo Tema" 
+               se pierde la posibilidad de modificar (al presionar sobre "Nuevo Tema" se pedirá la confirmación
+               antes de cambiar de contexto).
+        </p>
+        <p>
+               Desde <a href="#info_listarTemas_php">info.listarTemas.php</a> 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>
+        <p>
+               Desde <a href="#info_ingresarInfo_php">info.ingresarInfo.php</a> el usuario puede ingresar nuevas informaciones.
+               Los campos a completar son:
+        </p>
+               <ul>
+               <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>
+               </ul>
+               <p>
+               Una vez completados se procede a "Guardar Información".<br />
+               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, 
+               a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página, 
+               o presionar sobre "Nueva Información" se pierde la posibilidad de modificar (al presionar sobre 
+               "Nueva Información" se pedirá la confirmación antes de cambiar de contexto).
+        </p>
+        <p>
+               Desde <a href="#info_listarInfo_php">info.listarInfo.php</a> 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).<br />
+               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".<br />
+               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>
+        <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>
+        <p>
+               Desde <a href="#info_ingresarComentario_php">info.ingresarComentario.php</a> el usuario puede ingresar nuevos comentarios a informaciones existentes.
+               El campo a completar es:
+        </p>
+       <ul>
+                       <li><strong>Comentario</strong></li>
+               </ul>
+               <p>
+               Una vez completados se procede a "Guardar Comentario".<br />
+               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,
+                       a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página, 
+                       o presionar sobre "Nuevo Comentario" se pierde la posibilidad de modificar (al presionar sobre "Nuevo Comentario" 
+                       se pedirá la confirmación antes de cambiar de contexto).
+        </p>
+        <p>
+               En <a href="#info_mencionEspecial_php">info.mencionEspecial.php</a> 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>
     </body>
-</html>
-<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file
+</html>
\ No newline at end of file