Aplicación web para gestionar una colección personal de películas y series. Permite catalogar, organizar y buscar contenido audiovisual con autocompletado mediante la API de The Movie Database (TMDB). Incluye autenticación de usuarios, recuperación de contraseña con verificación por correo, y sistema de reportes de errores.
Hay algunas cosas que hay que hacer manualmente.
En la ruta:
[raíz-proyecto]/php
Existe un archivo llamado config.empty.php.
Ese archivo hay que renombrarlo a config.php o crear una copia del archivo y llamarlo config.php.
Una vez hecho, rellena todas las credenciales en ese único archivo:
// ── Base de datos ──────────────────────────────────────────────
$host = ""; // Ej: "localhost"
$dbname = ""; // Siempre debe ser "BibliotecaMultimedia"
$username = ""; // Usuario de la base de datos
$password = ""; // Contraseña de la base de datos
// ── Correo (PHPMailer) ─────────────────────────────────────────
define('MAIL_USERNAME', ''); // Tu correo de Gmail
define('MAIL_PASSWORD', ''); // Contraseña de aplicación generada
// ── The Movie Database API ─────────────────────────────────────
define('TMDB_API_KEY', ''); // Tu clave API de themoviedb.org
⚠️ config.phpestá en.gitignore. Nunca lo subas al repositorio.
Esta aplicación usa PHPMailer para enviar correos en los siguientes casos:
- Autenticación de dos factores
- Recuperación de contraseña
- Formulario de reporte de errores
Las credenciales se configuran únicamente en config.php (ver arriba). No hay que tocar ningún otro archivo.
Para obtener una contraseña de aplicación de Gmail:
- Activa la verificación en dos pasos en tu cuenta de Google.
- Ve a Gestionar tu cuenta de Google → Seguridad → Contraseñas de aplicaciones.
- Genera una contraseña para "Correo" y cópiala en
MAIL_PASSWORD.
Al añadir películas o series, el formulario permite buscar el título y autorellenar campos como nombre, sinopsis, géneros, año, puntuación y póster.
La clave API se configura únicamente en config.php (ver arriba). No hay que tocar ningún otro archivo.
¿Cómo obtener la clave?
- Entra en: https://www.themoviedb.org/settings/api
- Créate una cuenta.
- En tu perfil, busca la sección API.
- Selecciona el plan gratuito para uso no comercial.
- Rellena el formulario. La clave aparecerá como "Clave de la API".
La API tiene un límite de 40 peticiones por segundo. Más info: https://developer.themoviedb.org/docs/rate-limiting
¿Por qué tengo que renombrar los archivos?
Porque los enlaces que apuntan a ellos tienen esos nombres. El código subido a GitHub NO dispone de mi clave API por motivos evidentes.
¿Por qué en el caso de series el nombre del archivo es distinto?
Porque cuando empecé a implementar el uso de API, lo hice con la plataforma "Open Movie Database", pero autorellenaba los campos en inglés y yo quería que se rellenen en español. Por eso cambié a "The Movie Database", pero a los archivos de películas no les cambié los nombres.
¿Esa API que mencionas es gratuita?
Sí, pero tiene un uso limitado a 40 peticiones por segundo.
Más información: https://developer.themoviedb.org/docs/rate-limiting
¿Por qué no se autorrellenan todos los campos?
No me extenderé mucho porque el propósito de esta aplicación se puede leer en [raíz-proyecto]/html/manual.html.
En España no es ilegal hacer una copia de seguridad personal de un DVD comprado legalmente. Dicha copia, dependiendo del formato y calidad con que se haga, tendrá diferentes parámetros según el usuario que no se pueden autorellenar con el uso de la API.
Una vez configurados los apartados anteriores, se puede abrir la aplicación.
Al no existir la base de datos (por ser la primera ejecución), se redirigirá a un formulario que pedirá:
- nombre de usuario
- correo electrónico
- contraseña
Esto creará un usuario con rol propietario.
Este usuario podrá hacer todo en la aplicación excepto:
- borrar su cuenta
- cambiar su rol
- conceder a otro usuario el rol propietario
Si el proceso de instalación ha salido correctamente, la página redirigirá al inicio de sesión.
A partir de ahí ya se debería poder usar con normalidad, y no se podrá volver a acceder al formulario de instalación.
📝 (Si se me ha olvidado algún paso, actualizaré este archivo).
Gracias a todos los que habéis dedicado tiempo a ayudar durante el desarrollo de este proyecto.
(Algunos de los contribuyentes no tienen Github).
-
Nicolás García
🛠️ Sugerencias y comprobación de funcionamiento
🔗 https://github.com/nicolarus05 -
Lucía Martín
🛠️ Sugerencias y comprobación de funcionamiento -
Manolo Zurita
🛠️ Sugerencias y comprobación de funcionamiento -
Clara Molina
🛠️ Sugerencias y comprobación de funcionamiento
-
Ignacio Sánchez
✅ Comprobación de funcionamiento
🔗 https://github.com/Afirot -
Adrián Bertos
✅ Comprobación de funcionamiento
🔗 https://github.com/PumukyDev -
Rubén Martín
✅ Comprobación de funcionamiento
🔗 https://github.com/romilgildo -
Nuria Díez
✅ Comprobación de funcionamiento -
Jorge Ruano
✅ Comprobación de funcionamiento (GitHub no encontrado) -
Mabel Montoro
✅ Comprobación de funcionamiento
-
Manuel Varón
📚 Profesor — Entorno servidor en DAW
🔗 https://github.com/mvaronc -
Borja Molina
🚀 Profesor — Despliegue en DAW y comprobación pre-exposición
🔗 https://github.com/bmolzea
⭐ Si me he olvidado de alguien, las reclamaciones son más que bienvenidas 😄
Este proyecto es software libre y de código abierto, distribuido bajo los términos de la licencia GNU General Public License v3.0 (GPL-3.0).
Esto significa que eres libre de:
- Usar el software para cualquier propósito.
- Estudiar cómo funciona y adaptarlo a tus necesidades.
- Redistribuir copias.
- Mejorar el programa y publicar tus mejoras, de modo que toda la comunidad se beneficie.
Cualquier trabajo derivado de este proyecto deberá distribuirse bajo la misma licencia GPL-3.0.
Consulta el archivo LICENSE en la raíz del repositorio para leer el texto completo de la licencia, o visita https://www.gnu.org/licenses/gpl-3.0.html.
