Diferencia entre revisiones de «Usuario:ManuelRomero/ProgramacionWeb/INAEM2021/Sesiones/practica»

De WikiEducator
Saltar a: navegación, buscar
(Página creada con «{{:Usuario:ManuelRomero/ProgramacionWeb/CertificadoWeb2021/Sesiones/nav}}»)
 
 
(Una revisión intermedia por el mismo usuario no mostrado)
Línea 1: Línea 1:
 
{{:Usuario:ManuelRomero/ProgramacionWeb/CertificadoWeb2021/Sesiones/nav}}
 
{{:Usuario:ManuelRomero/ProgramacionWeb/CertificadoWeb2021/Sesiones/nav}}
 +
 +
__TOC__
 +
<div id=parrafo>
 +
 +
===Descripción del juego===
 +
*Se puede probar el juego el la web de prácticas
 +
http://manuel.infenlaces.com/dwes/practicas/asterMind/
 +
 +
*Este juego consiste en encontrar una secuencia de colores previamente establecida
 +
*Aquí una descripción del juego
 +
https://es.wikipedia.org/wiki/Mastermind
 +
*Nosotras vamos a hacer una versión un poco personal, adaptándola a unas especificaciones propias, pero basadas en la filosofía del juego
 +
*Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno
 +
{{MRM_Actividad|Title=Lista de requisitos|
 +
;RF1.- Al conectarnos aparecerá una descripción del juego y la opción de jugar
 +
;RF2.- Al dar empezar mostrará la opción de jugar 4 desplegables para seleccionar el juego y la opción de jugar
 +
;RF3.- Jugar
 +
;RF4.- Valorar el resultado
 +
;RF5.- Mostrar jugadas
 +
;RF6.- Controlar fin de juego: 15 jugadas o haber acertado la clave
 +
}}
 +
<br />
 +
 +
*En el siguiente diagrama de navegación (nombre que personalmente utilizo para este tipo de diagramas), podemos ver el flujo de ejecución de la aplicación
 +
 +
[[Archivo:Diagrama_nav_mm.png|800px|center]]
 +
<br />
 +
{{plegable|hide|Esqueleto del fichero jugar.php|
 +
<source lang=php>
 +
<?php
 +
 +
 +
spl_autoload_register(function ($clase){
 +
    require ("./clases/$clase.php");
 +
});
 +
session_start();
 +
 +
$clave =Clave::obtener_clave();
 +
 +
$opcion = $_POST['submit']==null;
 +
 +
 +
 +
switch ($opcion){
 +
    case "Resetear la Clave":
 +
        $clave::generar_clave();
 +
        $clave::guardar_clave();
 +
        $texto_informativo="Se ha reseteado la clave";
 +
        ///....
 +
        exit;
 +
    case "Jugar":
 +
        $jugada = new Jugada ($_POST['combinacion']);
 +
        $texto_informativo=$jugada->valida_jugada();
 +
 +
 +
        break;
 +
    case "Mostrar Clave":
 +
 +
 +
        break;
 +
    case "Ocultar Clave":
 +
 +
 +
    default: //Si no vengo del index, redericciono
 +
        header("Location:index.php");
 +
        exit;
 +
}
 +
 +
?>
 +
</source>}}
 +
;Diagrama de clases:
 +
*Debes implementar 3 clases, dos de ellas státicas (sería una librería, no crearemos objetos de la clase.
 +
[[Archivo:clases_mm.png]]
 +
 +
*A continuación vamos a analizar cada requisito.
 +
 +
===RF1 Página inicial===
 +
Al conectornos a la página, veremos  un mensaje de bienvenida con una pequeña especificación del juego y un botón para empezar que nos llevará a otra página '''''jugar.php'''''<br />
 +
[[Archivo:MarterMindRF1.png]]<br />
 +
*Para la ventana se puede jugar con el css para dar al texto un poco de color.<br />
 +
*En este caso he decidido crear un div de presentación y dar un poco de color a la lista de números, al h2 y al botón submit que me llevará a empezar el juego.<br />
 +
Un pantanllazo de la palicación<br />
 +
[[Archivo:Index_masterMind.png|450px|center]]<br />
 +
 +
===RF2 Empezar a jugar===
 +
*Ahora vamos a ver qué código debemos de especificar para la página que vamos a tener en jugar.<br />
 +
*Todas las acciones se realizarán en esta página, excepto la de dar información de final del juego, y como ya hemos visto, la primera pantalla que nos informa del juego.<br >
 +
 +
 +
*Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno
 +
{{MRM_Actividad|Title=Acciones para el requisito jugar|
 +
;RF2.1.- Generar la clave
 +
;RF2.2.- Mostrar la clave
 +
;RF2.3.- Mostrar la clave
 +
;RF2.4.- Mostrar un menú para poder establecer una jugada
 +
;RF2.5.- Mostrar el botón de jugar con la partida establecida
 +
}}
 +
<br />
 +
*Antes de poder establecer la implementación de estos requisitos vamos a pensar en la plantilla que hemos de generar o el diseño gráfico, pasa establecer dónde van a visualzarse la información.
 +
*Para ello usaremos display flex o diseño flexible dividiendo nuestra pantalla verticalemente en dos secciones.
 +
*Cada sección contendrá un tipo de información, el la primera tendremos 2 partes de información (opciones y menú de jugar) y a la derecha la información que corresponda en cada caso.
 +
*Vamos a establecer tres partes gráficas en nuestro juego:
 +
*Un posible mokup sacado directamente del css
 +
[[Archivo:css_MasterMind.png|600px|center]]
 +
 +
*Los contenidos que queremos que aparezcan en información deberán de ir en un div de información,
 +
*Así para cada parte
 +
*Ver el ejemplo  siguiente
 +
*Ŝe puede copiar el css o usar uno propio, o no usar, pero debe de haber 3 zonas con tres tipos de información:<br />
 +
1.-Botones de acciones : Mostrar Clave, Resetear Password.<br />
 +
2.-Menu de juego: 4 select para seleccionar la jugada y un botón de jugar<br />
 +
3.-Información:_ Segun proceda nos mostrará información según se especifica a continuación.<br />
 +
*Tal cual está implemntado el código, se puede mostrar estas tres zonas siguiendo este esquema
 +
<source lang=html5>
 +
<div class="contenedorJugar">
 +
    <div class="opciones"><!-- PArte izquierda de la pantalla, con dos secciones-->
 +
        <h2>OPCIONES</h2>
 +
        <fieldset><!-- Sección de acciones -->
 +
            <legend>Acciones posibles</legend>
 +
            <h2>Aquí las diferentes opciones</h2>
 +
            <h3>un fieldset dentro de (<span style="color:green">class=opciones</span>)</h3>
 +
        </fieldset>
 +
        <fieldset><!-- Sección de menú para realizar la jugada -->
 +
            <legend>Menú jugar</legend>
 +
            <h2>Aquí el menú para jugar</h2>
 +
            <h3>un fieldset dentro de (<span style="color:green">class=opciones</span>)</h3>
 +
            </form>
 +
        </fieldset>
 +
    </div>
 +
    <fieldset class="informacion"><!-- Parte derecha  de la pantalla para la información-->
 +
        <h2>INFORMACIÓN</h2>
 +
        <fieldset>
 +
            <legend>Sección de información</legend>
 +
            <h3>un fieldset dentro de (<span style="color:green">class=información</span>)</h3>
 +
        </fieldset>
 +
    </fieldset>
 +
</div>
 +
</source>
 +
[[Archivo:DiseñoGraficoMasterMind.png]]
 +
*Para este cometido se facilita el css al final del enunciado o en git que se indica
 +
;Ahora vamos a abordar cada una de las acciones
 +
 +
;1.- Generar la clave<br />
 +
*Debemos de generar una combinación de colores que el usuario a de acertar.
 +
*Esta combinación la llamaremos '''''$clave''''' y será un array de 4 colores.
 +
*Los colores se establecerá a  partir de una serie de colores previamente establecidos. Por ejemplo podemos usar los siguientes colores
 +
<source lang=php>
 +
  $colores = ['Azul', 'Rojo', 'Naranja', 'Verde', 'Violeta', 'Amarillo', 'Marrón', 'Rosa'];
 +
</source>
 +
*Para impementar este requisito lo que tendremos que hacer es que si no existe la clave, la creamos y la guardamos en una variable de sesión, y si existe la leemos ya que la podremos necesitar posteriormente
 +
*Este requisito no genera ninguna salida para la página, por lo que no altera el contenido
 +
 +
;2.- Visualizar la Clave<br />
 +
*Para este requisito debemos de tener una opción  (botón) que cuando el usuario lo presione se pueda visualizar la clave.<br />
 +
*El botón o input de tipo submit deberá de estar el la sección de opciones.
 +
*El contenido de la clave deberá de aparecer en la sección de información.
 +
*Estebleceremos también que el texto que aparezca en el botón cambie, de forma que cuando presionemos '''''Mostrar clave''''' nos muestre la clave y el texto del botón sea '''''Ocultar clave'''''.
 +
*A la vez si presionamos Ocultar clave que ya no se muestre y aparezca el texto que hubiera. Para ello vamos a controlar con una variable el texto que aparece en el botón.
 +
;Y el resultado
 +
*Con la opción de '''''mostrar clave'''''
 +
[[Archivo:mm_motrar_clave.png]]
 +
*Cuando hemos presionado y ahora muestra '''''ocultar clave'''''
 +
[[Archivo:mm_ocultar_clave.png]]
 +
<br />
 +
 +
 +
;3.-Mostrar el menú de jugadas y botón para jugar
 +
*Para ello tenemos que mostrar un formulario con 4 opciones para que el usuario elija 4 colores y un botón para darle a jugar
 +
*El resultado de dar a jugar lo implementaremos en el siguiente requisito.
 +
*Es importante que el formulario que generemos debe de estar en la sección de jugadas, para que aparezca ubicado en la sección que le hemos reservado en el diseño de la pantalla.
 +
*Vamos a usar una función que me devuelva un formulario, cada color lo seleccionaremos con un select ( un input desplegable con los colores permitidos)
 +
*Para que quede más vistoso, además del texto, cada opción tendrá un estilo en el class que se encargará de darle un color de fondo
 +
*Las opciones quedarán con colores<br />
 +
*Observalo en el dibujo como van cambiando de color<br />
 +
[[Archivo:mm_menu1.png]]<br />
 +
*PAra este comentido debemos hacer un pequeño javascript que implemento con el DOM de forma muy sencilla
 +
<script>
 +
<script>
 +
        function cambia_color(numero) {
 +
            color = document.getElementById("combinacion" + numero).value;
 +
            elemento = document.getElementById("combinacion" + numero);
 +
            elemento.className = color;
 +
        }
 +
    </script>
 +
</script>
 +
*Claramente cada select (cada uno de los del menú), tendrá que tener un id con nombre '''''combinacion1'''', '''''combinacion2''''', '''''combinacion3''''' y '''''combinacion4'''''.
 +
 +
*Es importante también, para dar mayor usabilidad al juego incorporar dos elementos:
 +
1.- Que se mantengan los colores de la última jugada<br />
 +
2.- Que si no se han seleccionado los cuatro colores nos informe de ello, igualmente manteniendo los colores que sí se seleccionaron<br />
 +
En la imagen siguiente vemos el resultado de haber selecconado 3 colores y presionar el botón jugar
 +
[[Archivo:mm_menu2.png]]<br />
 +
 +
 +
 +
=== RF3.- Jugar===
 +
Este requisito es la parte fundamental de la partida<br />
 +
Implicará que el usuario selecciona una jugada seleccionando los colores<br />
 +
Ya le hemos dado un aspecto visual para que seleccionar la jugada tenga un poco de color, para ello hemos usado  el css y un poco de java script (nunca está mal recordar, se aprende para no olvidar y usar).<br />
 +
Ahora en nuestro script querremo considerar esta opcion (que le hemos dado a jugar), por lo que lo que queremos que ocurrra deberá estar en un
 +
*Ahora vamos a contemplar los siguietnes requisitos
 +
{{MRM_Actividad|Title= Requisito 3: jugar|
 +
*'''''RF3.1''''' .- leer  La jugada
 +
*'''''RF3.1''''' .- Compararla con la clave
 +
*'''''RF3.2''''' .- Anotar la jugada en sesión.-
 +
*'''''RF3.3''''' .- Informar del resultado de la jugada (colores/posiciones acertadas)
 +
}}
 +
;RF3.1: Comparar jugada:
 +
*Ahora la comparamos con la clave.
 +
*En ello queremos que la comparación nos aporte dos valores:
 +
#El número de colores que hemos acertado
 +
#El número de posiciónes, es decir,  de los colores acertados cuantos los hemos especificado en la posición correcta.
 +
 +
*A la hora de mostrar el mensaje del resultado de una jugada, usaremos un redondel negro por cada color acertado en posición y un redondel blanco por los colores acertados en posiciones erróneas. pondremos un número en cada redondel.<br />
 +
*Además añadiremos los colores seleccionados en cada jugada
 +
*En la imagen siguiente vemos un posible resultado
 +
[[Archivo:Mm_resultado_jugadas1.png‎]]<br />
 +
*Para ello será necesario almacenar en una variable de sesión un array con cada jugada
 +
De cada jugada, debemos guardar los 4 colores con los que se ha jugado, el número de colores acertados y el número de posiciones (colores en el sitio esperado)
 +
[[Archivo:mm_variable_sesion.png]]<br />
 +
 +
 +
===RF4.- Valorar el resultado===
 +
Este requisito es bastante sencillo de implementar<br />
 +
No implica interactuación con el usuario, por lo que no detallaremos caso de uso, simplemente si al realizar una jugada hemos terminado vamos a ir a otra pantalla que nos especificará el fin del juego<br />
 +
;Esta situación se producirá la realizar 15 jugadas o al acertar los colores y posiciones
 +
 +
*Al estar en la finalización del juego  mostraremos todas las jugadas anteriores y el valor de la clave.

Última revisión de 22:37 20 feb 2023




Descripción del juego

  • Se puede probar el juego el la web de prácticas
http://manuel.infenlaces.com/dwes/practicas/asterMind/
  • Este juego consiste en encontrar una secuencia de colores previamente establecida
  • Aquí una descripción del juego
https://es.wikipedia.org/wiki/Mastermind
  • Nosotras vamos a hacer una versión un poco personal, adaptándola a unas especificaciones propias, pero basadas en la filosofía del juego
  • Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno


Icon activity.jpg
Lista de requisitos
RF1.- Al conectarnos aparecerá una descripción del juego y la opción de jugar
RF2.- Al dar empezar mostrará la opción de jugar 4 desplegables para seleccionar el juego y la opción de jugar
RF3.- Jugar
RF4.- Valorar el resultado
RF5.- Mostrar jugadas
RF6.- Controlar fin de juego
15 jugadas o haber acertado la clave




  • En el siguiente diagrama de navegación (nombre que personalmente utilizo para este tipo de diagramas), podemos ver el flujo de ejecución de la aplicación
Diagrama nav mm.png


Diagrama de clases
  • Debes implementar 3 clases, dos de ellas státicas (sería una librería, no crearemos objetos de la clase.

Clases mm.png

  • A continuación vamos a analizar cada requisito.

RF1 Página inicial

Al conectornos a la página, veremos un mensaje de bienvenida con una pequeña especificación del juego y un botón para empezar que nos llevará a otra página jugar.php
MarterMindRF1.png

  • Para la ventana se puede jugar con el css para dar al texto un poco de color.
  • En este caso he decidido crear un div de presentación y dar un poco de color a la lista de números, al h2 y al botón submit que me llevará a empezar el juego.

Un pantanllazo de la palicación

Index masterMind.png

RF2 Empezar a jugar

  • Ahora vamos a ver qué código debemos de especificar para la página que vamos a tener en jugar.
  • Todas las acciones se realizarán en esta página, excepto la de dar información de final del juego, y como ya hemos visto, la primera pantalla que nos informa del juego.


  • Vamos a realizar la aplicación estableciendo una serie de requisitos y abordandolos de uno en uno


Icon activity.jpg
Acciones para el requisito jugar
RF2.1.- Generar la clave
RF2.2.- Mostrar la clave
RF2.3.- Mostrar la clave
RF2.4.- Mostrar un menú para poder establecer una jugada
RF2.5.- Mostrar el botón de jugar con la partida establecida




  • Antes de poder establecer la implementación de estos requisitos vamos a pensar en la plantilla que hemos de generar o el diseño gráfico, pasa establecer dónde van a visualzarse la información.
  • Para ello usaremos display flex o diseño flexible dividiendo nuestra pantalla verticalemente en dos secciones.
  • Cada sección contendrá un tipo de información, el la primera tendremos 2 partes de información (opciones y menú de jugar) y a la derecha la información que corresponda en cada caso.
  • Vamos a establecer tres partes gráficas en nuestro juego:
  • Un posible mokup sacado directamente del css
Css MasterMind.png
  • Los contenidos que queremos que aparezcan en información deberán de ir en un div de información,
  • Así para cada parte
  • Ver el ejemplo siguiente
  • Ŝe puede copiar el css o usar uno propio, o no usar, pero debe de haber 3 zonas con tres tipos de información:

1.-Botones de acciones : Mostrar Clave, Resetear Password.
2.-Menu de juego: 4 select para seleccionar la jugada y un botón de jugar
3.-Información:_ Segun proceda nos mostrará información según se especifica a continuación.

  • Tal cual está implemntado el código, se puede mostrar estas tres zonas siguiendo este esquema
<div class="contenedorJugar">
    <div class="opciones"><!-- PArte izquierda de la pantalla, con dos secciones-->
        <h2>OPCIONES</h2>
        <fieldset><!-- Sección de acciones -->
            <legend>Acciones posibles</legend>
            <h2>Aquí las diferentes opciones</h2>
            <h3>un fieldset dentro de (<span style="color:green">class=opciones</span>)</h3>
        </fieldset>
        <fieldset><!-- Sección de menú para realizar la jugada -->
            <legend>Menú jugar</legend>
            <h2>Aquí el menú para jugar</h2>
            <h3>un fieldset dentro de (<span style="color:green">class=opciones</span>)</h3>
            </form>
        </fieldset>
    </div>
    <fieldset class="informacion"><!-- Parte derecha  de la pantalla para la información-->
        <h2>INFORMACIÓN</h2>
        <fieldset>
            <legend>Sección de información</legend>
            <h3>un fieldset dentro de (<span style="color:green">class=información</span>)</h3>
        </fieldset>
    </fieldset>
</div>

DiseñoGraficoMasterMind.png

  • Para este cometido se facilita el css al final del enunciado o en git que se indica
Ahora vamos a abordar cada una de las acciones
1.- Generar la clave
  • Debemos de generar una combinación de colores que el usuario a de acertar.
  • Esta combinación la llamaremos $clave y será un array de 4 colores.
  • Los colores se establecerá a partir de una serie de colores previamente establecidos. Por ejemplo podemos usar los siguientes colores
  $colores = ['Azul', 'Rojo', 'Naranja', 'Verde', 'Violeta', 'Amarillo', 'Marrón', 'Rosa'];
  • Para impementar este requisito lo que tendremos que hacer es que si no existe la clave, la creamos y la guardamos en una variable de sesión, y si existe la leemos ya que la podremos necesitar posteriormente
  • Este requisito no genera ninguna salida para la página, por lo que no altera el contenido
2.- Visualizar la Clave
  • Para este requisito debemos de tener una opción (botón) que cuando el usuario lo presione se pueda visualizar la clave.
  • El botón o input de tipo submit deberá de estar el la sección de opciones.
  • El contenido de la clave deberá de aparecer en la sección de información.
  • Estebleceremos también que el texto que aparezca en el botón cambie, de forma que cuando presionemos Mostrar clave nos muestre la clave y el texto del botón sea Ocultar clave.
  • A la vez si presionamos Ocultar clave que ya no se muestre y aparezca el texto que hubiera. Para ello vamos a controlar con una variable el texto que aparece en el botón.
Y el resultado
  • Con la opción de mostrar clave

Mm motrar clave.png

  • Cuando hemos presionado y ahora muestra ocultar clave

Mm ocultar clave.png


3.-Mostrar el menú de jugadas y botón para jugar
  • Para ello tenemos que mostrar un formulario con 4 opciones para que el usuario elija 4 colores y un botón para darle a jugar
  • El resultado de dar a jugar lo implementaremos en el siguiente requisito.
  • Es importante que el formulario que generemos debe de estar en la sección de jugadas, para que aparezca ubicado en la sección que le hemos reservado en el diseño de la pantalla.
  • Vamos a usar una función que me devuelva un formulario, cada color lo seleccionaremos con un select ( un input desplegable con los colores permitidos)
  • Para que quede más vistoso, además del texto, cada opción tendrá un estilo en el class que se encargará de darle un color de fondo
  • Las opciones quedarán con colores
  • Observalo en el dibujo como van cambiando de color

Mm menu1.png

  • PAra este comentido debemos hacer un pequeño javascript que implemento con el DOM de forma muy sencilla

<script> <script>

       function cambia_color(numero) {
           color = document.getElementById("combinacion" + numero).value;
           elemento = document.getElementById("combinacion" + numero);
           elemento.className = color;
       }
   </script>

</script>

  • Claramente cada select (cada uno de los del menú), tendrá que tener un id con nombre combinacion1', combinacion2, combinacion3 y combinacion4.
  • Es importante también, para dar mayor usabilidad al juego incorporar dos elementos:

1.- Que se mantengan los colores de la última jugada
2.- Que si no se han seleccionado los cuatro colores nos informe de ello, igualmente manteniendo los colores que sí se seleccionaron

En la imagen siguiente vemos el resultado de haber selecconado 3 colores y presionar el botón jugar

Mm menu2.png


RF3.- Jugar

Este requisito es la parte fundamental de la partida
Implicará que el usuario selecciona una jugada seleccionando los colores
Ya le hemos dado un aspecto visual para que seleccionar la jugada tenga un poco de color, para ello hemos usado el css y un poco de java script (nunca está mal recordar, se aprende para no olvidar y usar).
Ahora en nuestro script querremo considerar esta opcion (que le hemos dado a jugar), por lo que lo que queremos que ocurrra deberá estar en un

  • Ahora vamos a contemplar los siguietnes requisitos


Icon activity.jpg
Requisito 3: jugar
  • RF3.1 .- leer La jugada
  • RF3.1 .- Compararla con la clave
  • RF3.2 .- Anotar la jugada en sesión.-
  • RF3.3 .- Informar del resultado de la jugada (colores/posiciones acertadas)



RF3.1
Comparar jugada:
  • Ahora la comparamos con la clave.
  • En ello queremos que la comparación nos aporte dos valores:
  1. El número de colores que hemos acertado
  2. El número de posiciónes, es decir, de los colores acertados cuantos los hemos especificado en la posición correcta.
  • A la hora de mostrar el mensaje del resultado de una jugada, usaremos un redondel negro por cada color acertado en posición y un redondel blanco por los colores acertados en posiciones erróneas. pondremos un número en cada redondel.
  • Además añadiremos los colores seleccionados en cada jugada
  • En la imagen siguiente vemos un posible resultado

Mm resultado jugadas1.png

  • Para ello será necesario almacenar en una variable de sesión un array con cada jugada

De cada jugada, debemos guardar los 4 colores con los que se ha jugado, el número de colores acertados y el número de posiciones (colores en el sitio esperado) Mm variable sesion.png


RF4.- Valorar el resultado

Este requisito es bastante sencillo de implementar
No implica interactuación con el usuario, por lo que no detallaremos caso de uso, simplemente si al realizar una jugada hemos terminado vamos a ir a otra pantalla que nos especificará el fin del juego

Esta situación se producirá la realizar 15 jugadas o al acertar los colores y posiciones
  • Al estar en la finalización del juego mostraremos todas las jugadas anteriores y el valor de la clave.