=== GeeK! - Movie & Game Database ===
Contributors: kyazici
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PSMRT29N7K3CE
Tags: movie, game, games, movie database, film
Requires at least: 6.2
Tested up to: 7.0
Stable tag: 1.00.11
License: GPL-2.0+
Requires PHP: 7.0


Build a WordPress movie, TV & game database — cast, crew, platforms, reviews and critics, sourced from IMDb, TMDb and IGDB.

== Description ==

**GeeK!** turns WordPress into a full movie, TV-show and video-game database. Catalogue titles, cast & crew, characters, companies, gaming platforms and engines — then let your visitors rate, review, build lists and follow release calendars, all from a fast single-page front end.

It is the most complete cinema-and-games platform available for WordPress: you get the data model, the import tools, the front-end apps and the membership system in one plugin. Pull rich metadata — posters, backdrops, galleries, trailers, cast, crew, ratings and release dates — straight from **IMDb**, **TMDb** and **IGDB**, and it lands in your own database, on your own site.

= What you can build =

* A **movie & TV database** with full cast & crew, galleries, trailers, box-office, seasons and episodes.
* A **video-game database** with platforms, engines, companies, game modes, perspectives, age ratings and per-platform release dates.
* Editorial **reviews and critic scores**, plus community **ratings**, **wishlists** and **watch/played** tracking.
* User-built **lists** (top 10s, watchlists, collections) that are sortable and shareable.
* **Member profiles** with contribution scores, earned badges, votes, reviews and activity feeds.
* A configurable **homepage** built from drag-and-drop widgets (hero, recently released, coming soon, most anticipated, latest critics, born today and more).

= Key features =

* **Custom post types** for movies, TV shows, episodes, games, comics, people, characters, companies, platforms, engines, universes, families and lists — each with its own permalink and template.
* **Import from IMDb, TMDb and IGDB** — fetch a title and its cast, crew, images, videos and release dates in a couple of clicks. Bulk import names, titles, credits, galleries and trailers.
* **Token Services** — a metered fetching system so you only ever pay for the exact rows you import; galleries and trailers you already own are skipped automatically, so tokens are never wasted.
* **Single-page front end** — catalogue, single-title, person, character, company, platform, list and profile views all run as fast React apps over the WordPress REST API.
* **Reviews & critics** — long-form editorial critic articles with scores, plus short community reviews, kept in sync with each title's average rating.
* **Members & moderation** — front-end register/login, account statuses, a banned registry and a Users moderation screen.
* **Homepage widget builder** — assemble a special front page from sortable, resizable widgets, or point it at any WordPress page.
* **Companion themes** — a family of drop-in themes (movie and game oriented) that reskin every front-end surface through the `--geekui-*` design-token contract without touching the plugin markup.
* **Shortcodes & cards** — embed a title card anywhere with `[geekpress_card]`, or mount any catalogue/profile view with the `[geekpress]` shortcode.
* **Media everywhere** — YouTube, Vimeo, Spotify and Dailymotion embeds, image galleries with a full-screen viewer, and per-title trailer reels.

= Movie mode & Game mode =

GeeK! runs as a **movie site**, a **game site**, or **both** at once. A single Site Mode setting decides which catalogues, navigation and homepage widgets appear, so the same plugin powers a film database and a games database from one codebase.

== DEMO ==

See it running live:

* **Movie demo site:** [https://movie.geekplug.in/](https://movie.geekplug.in/)
* **Game demo site:** [https://game.geekplug.in/](https://game.geekplug.in/)

Example pages:

* [Single Movie](https://movie.geekplug.in/movie/the-lord-of-the-rings-the-fellowship-of-the-ring/)
* [Movies catalogue](https://movie.geekplug.in/movies/)
* [Single Game](https://game.geekplug.in/game/grand-theft-auto-vi/)
* [Games catalogue](https://game.geekplug.in/games/)
* [Platforms](https://game.geekplug.in/platforms/)

== Installation ==

1. Download the GeeK! plugin, or upload it to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu.
3. Open **GeeK!** in the dashboard and choose your Site Mode (Movie, Game or Both).
4. Connect a data source (IMDb / TMDb / IGDB) under **GeeK! → Token / TMDb API** to start importing.
5. (Optional) Install a companion theme and build your front page under **GeekPress Theme → Homepage**.

= Database Tables =

Upon installation, the plugin automatically creates a series of database tables to store and manage data efficiently. These tables are prefixed with your WordPress database prefix (e.g. `wp_`) to avoid conflicts. Below is the full list of tables the plugin adds:

- `{{prefix}}geekp_age_descriptors`: Stores information on age-related descriptors.
- `{{prefix}}geekp_age_ratings`: Contains age ratings for content.
- `{{prefix}}geekp_age_standards`: Lists the standards used for age ratings.
- `{{prefix}}geekp_akas`: Alternate names or aliases for content.
- `{{prefix}}geekp_cache`: Caching mechanism for storing temporary data.
- `{{prefix}}geekp_categories`: Categories for organizing content.
- `{{prefix}}geekp_chars`: Character information within the content.
- `{{prefix}}geekp_companies`: Companies involved in content creation or distribution.
- `{{prefix}}geekp_content_ages`: Age-specific content information.
- `{{prefix}}geekp_content_comps`: Associations between content and companies.
- `{{prefix}}geekp_content_img`: Images related to content.
- `{{prefix}}geekp_content_lists`: Lists that organize content in various ways.
- `{{prefix}}geekp_content_videos`: Videos associated with content.
- `{{prefix}}geekp_countries`: Countries related to content production or distribution.
- `{{prefix}}geekp_engines`: Game engines or software used to create content.
- `{{prefix}}geekp_engine_op`: Operations related to game engines.
- `{{prefix}}geekp_episodes`: Episodes or serialized content information.
- `{{prefix}}geekp_families`: Content families or series.
- `{{prefix}}geekp_game_modes`: Different modes available in games.
- `{{prefix}}geekp_game_op`: Operations specific to game functionalities.
- `{{prefix}}geekp_game_relationships`: Relationships between games, such as sequels or prequels.
- `{{prefix}}geekp_game_themes`: Themes or settings of games.
- `{{prefix}}geekp_images`: General image storage.
- `{{prefix}}geekp_jobs`: Job roles or titles related to content creation.
- `{{prefix}}geekp_langs`: Languages supported or relevant to the content.
- `{{prefix}}geekp_lang_supports`: Language support details for content.
- `{{prefix}}geekp_lists`: General purpose lists.
- `{{prefix}}geekp_persons`: Persons involved in content creation or featured within.
- `{{prefix}}geekp_perspectives`: Camera perspectives or viewpoints in games.
- `{{prefix}}geekp_platforms`: Platforms on which content is available.
- `{{prefix}}geekp_platform_op`: Operations related to platforms.
- `{{prefix}}geekp_platform_versions`: Specific platform versions.
- `{{prefix}}geekp_programs`: Programs or software associated with content.
- `{{prefix}}geekp_rating`: Content ratings.
- `{{prefix}}geekp_regions`: Regions for content distribution or relevance.
- `{{prefix}}geekp_releases`: Content release information.
- `{{prefix}}geekp_titles`: Titles of content.
- `{{prefix}}geekp_title_genres`: Genres associated with titles.
- `{{prefix}}geekp_title_op`: Operations related to titles.
- `{{prefix}}geekp_title_people`: Associations between titles and people.
- `{{prefix}}geekp_universes`: Universes or worlds within which content exists.
- `{{prefix}}geekp_universe_op`: Operations related to universes.
- `{{prefix}}geekp_user_contents`: Logs user actions (ratings, reviews, wishlists, watch/played, favourites).
- `{{prefix}}geekp_videos`: Video storage related to content.
- `{{prefix}}geekp_websites`: Websites associated with content.

These tables are crucial for the plugin's functionality, allowing detailed management and organization of content. If you need to perform direct database operations, refer to this list to understand the structure and purpose of each table.

= Custom Post Types =

The GeeK! plugin adds several custom post types to your WordPress site during installation:

- **Movie:** Registered as `gp_movie` — slug: movie
- **TV Show:** Registered as `gp_tvshow` — slug: tv
- **Episode:** Registered as `gp_episode` — slug: episode
- **Game:** Registered as `gp_game` — slug: game
- **Comic:** Registered as `gp_comic` — slug: comic
- **Person:** Registered as `gp_person` — slug: name
- **Character:** Registered as `gp_char` — slug: character
- **Company:** Registered as `gp_comp` — slug: company
- **Platform:** Registered as `gp_platform` — slug: platform
- **Engine:** Registered as `gp_engine` — slug: engine
- **Universe:** Registered as `gp_universe` — slug: universe
- **Family:** Registered as `gp_family` — slug: family
- **List:** Registered as `gp_list` — slug: list

These custom post types let you organize your content effectively within the GeeK! plugin.

Custom Post Types determine the permalink structure for entries such as a movie or game. When you input data for a movie or game, it is added under the defined custom post. For instance, a movie titled "Lord of the Rings: Fellowship of the Ring" would be accessible at `yoursite.com/movie/lord-of-the-rings-fellowship-of-the-ring`. Each custom post type, like "movie", has a slug. To modify a slug, adjustments are made within your theme's `functions.php` file.

If you lack the technical expertise, consider using our support service here:
[https://pluginpress.net/support/change-custom-post-types-for-geek-plugin](https://pluginpress.net/support/change-custom-post-types-for-geek-plugin)
This is also a way to financially support the plugin.


== Usage ==

- Add movies, TV shows and games through the GeeK! interface, or import them from IMDb, TMDb and IGDB.
- Choose a Site Mode (Movie, Game or Both) to shape the catalogues, navigation and homepage.
- Build a homepage from sortable widgets, or pick any WordPress page as your front page.
- Let members rate, review, wishlist and build lists; moderate them from the Users screen.
- Install a companion theme to reskin the whole front end without touching the plugin.



### Undocumented Use of 3rd Party Services

We permit plugins to require the use of 3rd party (i.e. external) services, provided they are properly documented in a clear manner.

The GeeK! plugin relies on third-party services under certain circumstances. These services are integral to the functionality and features offered by the plugin. We acknowledge the importance of transparency regarding the use of such services.

= Service Details =

### PluginPress.net API Services
- **Service Purpose:** The plugin uses PluginPress.net API services and connections for specific functionality (grabbing content data from IMDb / TMDb / IGDB, metered Token Services, and account/subscription connectivity).
- **Service Link:** [PluginPress.net API Services](https://pluginpress.net/api/{services})
- **Service Terms & Conditions:** [PluginPress.net Terms of Service](https://pluginpress.net/terms-and-conditions)
- **Service Privacy Policy:** [PluginPress.net Privacy Policy](https://pluginpress.net/privacy-policy)

### Youtube Video Player Embed
- **Service Purpose:** The plugin embeds YouTube videos for multimedia content.
- **Service Link:** [Youtube Developer](https://developers.google.com/youtube/)
- **Service Terms of Use:** [Youtube Terms of Service](https://www.youtube.com/static?template=terms)
- **Service Privacy Policy:** [Youtube Privacy Policy](https://www.google.com/policies/privacy/)

### Vimeo Video Player Embed
- **Service Purpose:** The plugin embeds Vimeo videos for multimedia content.
- **Service Link:** [Vimeo Developer](https://developer.vimeo.com/)
- **Service Terms of Use:** [Vimeo Terms of Service](https://vimeo.com/terms)
- **Service Privacy Policy:** [Vimeo Privacy Policy](https://vimeo.com/privacy)

### Spotify Audio Player Embed
- **Service Purpose:** The plugin embeds Spotify audio for multimedia content.
- **Service Link:** [Spotify Developer](https://developer.spotify.com/documentation/widgets/)
- **Service Terms of Use:** [Spotify Terms of Service](https://www.spotify.com/us/legal/end-user-agreement/)
- **Service Privacy Policy:** [Spotify Privacy Policy](https://www.spotify.com/us/legal/privacy-policy/)

### Dailymotion Video Player Embed
- **Service Purpose:** The plugin embeds Dailymotion videos for multimedia content.
- **Service Link:** [Dailymotion Developer](https://developer.dailymotion.com/player/)
- **Service Terms of Use:** [Dailymotion Terms of Service](https://www.dailymotion.com/legal/terms)
- **Service Privacy Policy:** [Dailymotion Privacy Policy](https://www.dailymotion.com/legal/privacy)

== Frequently Asked Questions ==

= Can I run a movies-only or games-only site? =
Yes. A single Site Mode setting switches the plugin between Movie, Game and Both, changing the catalogues, navigation and homepage widgets to match.

= Where does the data come from? =
You import it from IMDb, TMDb and IGDB. The data is fetched into your own database on your own site — nothing depends on an external site staying online after import.

= Do I have to pay for imports? =
Importing uses metered Token Services so you only spend on the exact rows you fetch. Content you already own (galleries, trailers, cast) is skipped automatically, so tokens are never wasted.

= Does it work with my theme? =
The front end runs on its own React apps and works with any theme. For a fully designed experience, install one of the GeeK! companion themes, which reskin every surface through the `--geekui-*` design tokens.

= Can visitors rate and review titles? =
Yes. Members can rate, write reviews, wishlist upcoming titles, mark watched/played, build lists and earn badges, all from the front end. You moderate members from the Users screen.

== Screenshots ==
1. Movie site homepage — hero trailer, Up Next and Latest Critics.
2. Single movie page — hero backdrop, ratings, cast & crew, gallery and trailers.
3. Movies catalogue — sortable, filterable poster grid.
4. TV Shows catalogue.
5. Game site homepage — game-oriented widgets and release calendar.
6. Single game page — trailers, ratings, wishlist, genres, gameplay and platforms.
7. Games catalogue — filter by rating, release date and title.
8. Platforms directory.
9. Companies — developers & publishers, A–Z.
10. Names / people directory.

== Changelog ==

= 1.00.00 - 2026-07-15 =
* First stable release of the rebuilt GeeK! platform.
* Dual Site Mode: run as a movie site, a game site, or both from one plugin.
* Full single-page front end (catalogue, single-title, person, character, company, platform, list and profile views) over the REST API.
* IMDb, TMDb and IGDB import with bulk names, titles, credits, galleries and trailers.
* Token Services: metered imports that never re-charge for content you already own; already-fetched galleries and trailers are skipped.
* Reviews and editorial critic articles kept in sync with each title's average rating.
* Members & moderation: front-end register/login, account statuses, banned registry and Users screen.
* Homepage widget builder with sortable, resizable widgets (hero, recently released, coming soon, most anticipated, latest critics, born today and more).
* Companion themes reskin the whole front end through the `--geekui-*` token contract.
* `[geekpress_card]` and `[geekpress]` shortcodes for embedding cards and views.
* Subscription-aware theme updates and downloadable file access via PluginPress.

= 0.75.54 - 2025-03-02 =
* Hot fix for bugs.
= 0.75.53 - 2024-09-06 =
* Hot fix for image links.
= 0.75.51 - 2024-08-16 =
* Major bugs have been fixed.
= 0.75.02 - 2024-07-31 =
* Hot fixes.
= 0.75.01 - 2024-07-21 =
* Hot fixes on CSS.
= 0.75.00 - 2024-07-22 =
* New front end is ready to use.
