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
-
Download the latest version of the installation package (
thoth.tar.gz) from the Release page. -
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.
Once a monograph is registered, metadata updates are automatic. Unpublish the monograph, edit the data, and the changes will be synchronized with Thoth upon republication.
It is also possible to manually update the metadata in Thoth by clicking the 'Update Metadata' button next to the publication status.
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.
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 | ||||
| Keyword | Subject(Type: Keyword) | ||||
| Citation | Reference |
# Install PHP dependencies
composer install
# Install Node.js dependencies and build frontend assets
npm install
npm run build# From the OMP root directory
php lib/pkp/lib/vendor/phpunit/phpunit/phpunit --configuration lib/pkp/tests/phpunit.xml -v 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