English | Español | Português Brasileiro
Integrates OMP (Open Monograph Press) with Thoth, an open metadata management platform for books. This plugin enables the registration and synchronization of book- and chapter-level metadata directly from OMP into Thoth, where it can be disseminated in multiple industry-standard formats including ONIX, MARC, KBART, and Crossref XML.
This plugin is compatible with the following PKP applications:
- OMP 3.3.0-x
- OMP 3.4.0-x
- OMP 3.5.0-x
-
From the Release page, download the installation package (
thoth.tar.gz) that is compatible with your OMP version. -
Access the administration area of your OMP website through the Dashboard. Navigate to
Settings>Website>Plugins>Upload a new plugin, and select thethoth.tar.gzfile. -
Click 'Save' to install the plugin.
After enabling the plugin, go to the plugin settings and fill in:
- Personal access token: A valid Thoth personal access token used to authenticate API requests.
- Custom Thoth API: Check this option to use a custom Thoth API instead of the official one.
- Thoth API URL: The URL of the custom Thoth API (only required when the custom API option is enabled).
Register metadata in Thoth during the publishing process by selecting the option to register metadata in the publish modal and choosing an imprint.
Register metadata for already-published monographs by using the 'Register' button next to the publication status.
After registration, some changes to the book's catalog entry, titles, and abstracts are sent to Thoth automatically when they are saved.
To reconcile the complete record, click Update Metadata next to the publication status. This action synchronizes the book and its chapters, including contributors, publication formats and links, language, subjects, keywords, references, and chapter order.
OMP is the source for the metadata managed by this synchronization. Information added or changed in OMP is reflected in Thoth, and information removed from OMP is also removed from Thoth when possible. Locations managed by Thoth itself are preserved.
If the plugin cannot safely identify the corresponding record in Thoth, it stops the synchronization instead of making an uncertain association. A warning may also be shown when a publication format cannot be removed from an active work in Thoth.
After metadata is registered, a link to the book on Thoth will appear at the top of the publication workflow.
The plugin can send publication files, the front cover, and a featured video to Thoth. These features are available
after the book has been registered in Thoth and require the configured Thoth user to have the cdnWrite permission, which is available to publishers subscribing to Thoth Open Metadata's Obelisk, Sphinx, and Pyramid service packages.
In the publication workflow, open the publication formats grid and use Upload to Thoth on the desired format. The action appears below the format details and above the files associated with it.
In the upload form, select a file and indicate whether it belongs to the monograph or to a chapter. The selected monograph or chapter must have a DOI. Files can be up to 50 MB.
After the upload, the View button in the Thoth files column opens a list of the monograph and chapter files hosted by Thoth. Each filename is a link to the file identified by its DOI.
On the public book page, files hosted by Thoth are displayed alongside the files from OMP publication formats.
In the catalog entry form, upload the book cover and select Host this cover image file on Thoth, below the cover field. After the publication is saved and synchronized, the public book page uses the cover hosted by Thoth. Clearing this option stops the plugin from using the previously hosted cover.
Open the Marketing tab in the publication workflow and select Featured video, below Publication dates. Add a title and upload an MP4, WebM, or MOV file. The file is hosted by Thoth and displayed with playback controls on the public book page, after the book information and synopsis. Each book can have one featured video.
On the Thoth management page, you can submit a selection of titles from OMP into Thoth in bulk.
- Only basic HTML tags are preserved in text fields:
<strong>,<mark>,<em>,<i>,<u>,<sup>,<sub>,<ul>,<ol>, and<li>. All other tags will be stripped. - ISBN must be properly formatted as ISBN-13 (e.g.,
978-3-16-148410-0).
Click here to see the data relationship between OMP and Thoth
| OMP | Thoth | ||||
|---|---|---|---|---|---|
| Submission | Work | ||||
| WorkType | WorkType | ||||
| SubmissionUrl | LandingPage | ||||
| Publication | |||||
| FullTitle | FullTitle | ||||
| Title | Title | ||||
| Subtitle | Subtitle | ||||
| Abstract | Abstract | ||||
| Version | Edition | ||||
| DOI | DOI | ||||
| DatePublished | PublicationDate | ||||
| License | License | ||||
| CopyrightHolder | CopyrightHolder | ||||
| CoverUrl | CoverImageUrl | ||||
| Author | Contribution | ||||
| UserGroupId | ContributionType | ||||
| PrimaryContactId | MainContribution | ||||
| Sequence | ContributionOrdinal | ||||
| GivenName | FirstName | ||||
| LastName | FamilyName | ||||
| FullName | FullName | ||||
| Biography | Biography | ||||
| Affiliation | Affiliation | ||||
| Chapter | Work(Type: Chapter) | ||||
| FullTitle | FullTitle | ||||
| Title | Title | ||||
| Subtitle | Subtitle | ||||
| Abstract | Abstract | ||||
| Pages | pageCount | ||||
| DatePublished | PublicationDate | ||||
| DOI | DOI | ||||
| SubmissionLocale | Language | ||||
| PublicationFormat | Publication | ||||
| EntryKey | PublicationType | ||||
| IdentificationCode | ISBN | ||||
| Location | |||||
| RemoteUrl/FileUrl | FullTextUrl | ||||
| SubmissionUrl | LandingPage | ||||
| Subject | Subject(Type: detected scheme or Keyword) | ||||
| Keyword | Subject(Type: Keyword) | ||||
| Citation | Reference |
OMP offers two complementary ways to describe a publication:
- Keywords are free terms that help readers discover the publication. Every keyword is sent to Thoth as a keyword and is never treated as a custom classification.
- Subjects can be descriptive terms or codes from recognized classification systems, such as LCC, BISAC, BIC, and Thema. When the classification can be confirmed, Thoth records the subject using the corresponding system.
- When a subject cannot be confidently associated with a classification system, it is kept as a keyword instead of being discarded or assigned an uncertain classification.
- Subjects associated with another clearly identified vocabulary are recorded as a custom classification.
To make the Subjects field available, go to Settings > Workflow > Submission > Metadata, select Enable subject metadata, and save the changes. In the same settings, choose whether the field should be available only to the editorial team, requested from authors, or required during submission.
Editors can enter the code alone, such as GTK or EDU000000. They can also identify the classification system
with a prefix, such as THEMA:GTK or BISAC:EDU000000. Classification information included in metadata imported
into OMP 3.5 is also recognized automatically.
# Install PHP dependencies
composer install
# Install Node.js dependencies and build frontend assets
npm ci
npm run build# From the OMP root directory
php lib/pkp/lib/vendor/bin/phpunit -c lib/pkp/tests/phpunit.xml --no-coverage plugins/generic/thoth/testsThis plugin was idealized and sponsored by Thoth Open Metadata.
Developed by Lepidus Tecnologia.
This plugin is licensed under the GNU General Public License v3.0 - See the License file.
Copyright (c) 2024-2026 Lepidus Tecnologia
Copyright (c) 2024-2026 Thoth Open Metadata