Introduction

This is the documentation for the 7.x version of the Discogs project:
https://drupal.org/project/discogs

This project provides a Discography framework. It is designed to serve two purposes:

  1. To provide Drupal content types for storing discography information.
  2. To provide a modular framework for importing discography information from third-party API's (including, but not limited to, the Discogs.com API).

There are a number of modules included in this project:

  • Track Field: A custom Field representing a music track, which can be attached to any content type.
  • Release Node: Provides a Release content type for the Discography package.
  • Track Node: Provides a Track content type for the Discography package. Note that Track information is completely independent of Release information.
  • Discography Mediator: Acts as a mediator between the Discogs.com Adapter, the Release Provider, and the user.
  • Discogs.com Adapter: The Provider Adapter for the Discogs.com API.
  • Release Adapter: The Entity Adapter for the Release content type.

History and Purpose

The 7.x version of the Discogs project has be rewritten from the ground up, and has very little in common with the 6.x version.

After the 6.x version of Discogs was coded, users filed various requests in the issue queue. Could the module save into their own content type? Could it integrate with other discography modules, like Pushtape Discography? Could it import from sources other than Discogs.com? Could tracks be their own content types?

These are all excellent ideas. Unfortunately, none of this was possible if Discogs were to remain a single module. So, for the 7.x version of the project, the Discogs module became the Discography framework.

The names of the modules were altered slightly to reflect this change. Instead of "discogs" (for Discogs.com), there are now multiple modules with a prefix of "discog" (for Discography).

Where To Go From Here

Those who are not interested in how these modules interact, and instead just want to use the project, should read the Installation and Use Cases page. Also note that there is a separate guide to using the Track Field module.

For the theory behind what these modules do, see the Framework Organization page.

To develop your own modules that plug in to the framework, see the page on Developing Modules for the Discography Framework.