Skip to content

Latest commit

 

History

History
218 lines (176 loc) · 9.12 KB

README.md

File metadata and controls

218 lines (176 loc) · 9.12 KB
Raw

php4dvd 3.X

php4dvd is a small yet powerful, php/mysql powered movie database.

Features

  • Add movie information from IMDb.com
    • (directors, actors, poster, language...)
  • Keeps track on what movies you watched, bought or loaned out to a friend
  • Add covers/posters to your movies
  • What do you think about a movie? Write it down in personal notes
  • Search function (title, year, plot)
    • Age rating: filter by age (Parental Guidance/MPAA)
    • Filter by: categories, format, movie, tv, seen, own, favourite
    • Sort it by: name, year, rating, format, added, loaned out
    • Results: limit amount of movies shown
    • Layouts: choose between five different display layouts
  • Multi-user (admin, editor, guest)
  • Multiple languages
  • Very configurable, easy to use
  • Editable templates using Smarty (no PHP knowledge is required)
  • SEO Friendly URL
  • Automatic YouTube trailers

Requirements (supported versions)

  • PHP 7.4 / PHP 8.0 / PHP 8.1
  • MySQL 5.7 / MySQL 8.0 / MariaDB 10.6
  • GD2 library to be able to upload (and resize) covers
  • PDO library
    • PDO driver for MySQL/MariaDB
  • cURL

Installation

  1. Download and unzip php4dvd package if you haven't already.
  2. Create a database for php4dvd on your web server, as well as a MySQL (or MariaDB) user who has all privileges for accessing and modifying it.
  3. Upload the php4dvd files to the desired location on your web server:
  4. Run the php4dvd installation script by accessing the URL in a web browser.
  5. Manually remove the install/ directory.
  6. Log into php4dvd using the username: admin, password: admin.

Upgrade

Delete all files and folders except:

config/config.php
config/version.inc.php
movies/*
movies/covers/*

v3.1.1 or older: You will need to change your $settings["defaultlanguage"] inside config.php

$settings["defaultlanguage"] = "en"; // English
$settings["defaultlanguage"] = "nl"; // Nederlands
$settings["defaultlanguage"] = "sv"; // Swedish
$settings["defaultlanguage"] = "pl"; // Polish
  1. Download and unzip php4dvd package if you haven't already.
  2. Upload the php4dvd files to the desired location on your web server:
  3. Run the php4dvd installation script by accessing the URL in a web browser.
  4. Manually remove the install/ directory.
  5. Log into php4dvd using your username/password.
  6. Empty your browser's cache or force refresh with CTRL+F5 (Win), Ctrl+Shift+R (Win/Linux) or Command+Shift+R (Mac).

Screenshots

Login Movie collection Search Movie Movie trailer Add movies Search from IMDb Users

Configuration / FAQ

You will find all configurable options inside config/config.default.php, all of which can be set in your config/config.php file. By default, guest users can't view your movie collection. If you want guest users to view your collection, set the guestview variable to true in config/config.php after installation or upgrade.

SEO Friendly URL (pretty_url)

Activate inside config/config.default.php or config/config.php and read the instructions inside .htaccess.

Age rating / Parental Guidance / MPAA

Activate inside config/parental.guidance.php or config/config.php and read the instructions inside config/parental.guidance.php.

Configure languages

Tell IMDb which is the preferred language (e.g. en-US, de-DE, pt-BR)

Sometimes IMDb gets unsure that the specified language are correct, if you only specify your unique language and territory code (de-DE). In the example below, you can find that we have chosen to include de-DE (German, Germany), de (German) and en (English). If IMDb can’t find anything matching German, Germany, you will get German results instead or English if there are no German translation.

$settings["imdbphp"]["language"] = 'de-DE,de,en';

Please use The Unicode Consortium Langugage-Territory Information database for finding your unique language and territory code.

Language Code Territory Code
German de Germany {O} DE

After you have found your unique language and territory code you will need to combine them. Start with language code (de), add a separator (-) and at last your territory code (DE); de-DE. Now include your language code (de); de-DE,de. And the last step add English (en); de-DE,de,en.

Change geolocation

Sometimes your server aren't located in your preferred area (language), so you can use another ip address (e.g. a public proxy), for tricking IMDb geolocation system. There are some movies/TV Series that have the English translation in "World-wide" and the only way to retrieve them is an US/UK IP-address.

$settings["imdbphp"]["ip_address"] = '';

Keyboard shortcuts

  • CTRL+F, CMD+F or F3
    • Focus search field
  • DELETE (in search field)
    • Removes text in search field
  • END (in search field)
    • Reset everything (except: sort by, results per page and layout)

Internal Server Error

Try to run the website, but if the site failes opening with a Internal Server Error, adjust the .htaccess file in the root of the site. Try to remove the Options line by placing a # at the beginning of the line. Otherwise remove the <Files> section. These settings might fail because of the permissions of your webserver.

SSL certificate problem: unable to get local issuer certificate

Visible as ERROR 500 in your browser when adding movie/tv posters from IMDb.

Windows

  1. Download cacert.pem.
  2. Store it somewhere on your server.
    C:\php\extras\ssl\cacert.pem
  3. Open your php.ini and add the following under [curl].
    curl.cainfo = "C:\php\extras\ssl\cacert.pem"
  4. Restart your web server.

Linux

I recommend that you update your local ca-bundle.crt or ca-certificates.crt file for your whole system.
There are different best practices depending on OS. Google is your best bet, for finding the safest way.

You can also use a local cacert.pem like in Windows.

/etc/ssl/certs/cacert.pem

curl.cainfo = "/etc/ssl/certs/cacert.pem"

Templates

You can customize your site by adding your own template. Take a look at the tpl/default/ directory and copy this directory to your own tpl directory. Now you can adjust the config/config.php to your new template. Check all template files and try to adjust them to your own whishes.

If you just want to change the color, please check config/config.defaults.php for available skins.

Thanks to

Thanks to cyberolf. He originally created php4dvd.

Thanks to morphias0. He wrote the first automatic installer/upgrade script and came up with some extra features.

Thanks to Izzy from IzzySoft. He wrote the imdbphp class to be able to search for movies at IMDb.com. Big shoutout to Tom for continuing his work.

Libraries

HTML/CSS/JavaScript

PHP

License

This file is part of php4dvd.

php4dvd is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

php4dvd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with php4dvd. If not, see http://www.gnu.org/licenses/.