Add advice to the readme about VG Wort aproval of custom user IDs

Created on 7 March 2024, 7 months ago
Updated 26 March 2024, 6 months ago

Problem/Motivation

The module uses the entity's UUIDs as counter ID. After setting up the module and testing it (drush vgwort:send node 1) I got the following error:

Server error: `POST https://tom-test.vgwort.de/api/external/metis/rest/message/v1.0/newMessageRequest` resulted in a `500 Internal Server Error` response:
{"message":{"errorcode":1,"errormsg":"Privater Identifikationscode: Für den eingegebenen Wert existiert keine Zählmark (truncated...)

It's because a custom counter ID is used which requires approval from VG Wort. See VG Wort Integration Manual:

2.1.2 Publisher key as Counter ID

Publishers often use unique, internal keys for their articles. These keys can be used as Counter IDs. In such cases, the publisher key will be used as both the public and private identification code.

The following points have to be considered:

  • A publisher key used as a Counter ID starts with the prefix “vgzm.-“ followed by the unique key. The placeholder “” has to be replaced with the "Karteinummer" (registration number) of the publisher within the VG WORT.
  • The publisher key must not contain any special characters (i.e. only characters [a-z][A-Z][0-9] the dot, hyphens and underscore).
  • The key has to be unique within the publishing house.

Example: vgzm.970-123456789

Before using a publisher key as a counter ID, please be sure to contact VG WORT first and send an example publisher key (email metis.support@vgwort.de)! Using counting via publisher keys requires a separate activation. If these steps are not carried out, we cannot offer counting of visits via publisher keys!

Steps to reproduce

Setup the module as described in Readme and try to send a registration notification, i.e. using drush: drush vgwort:send node 1

Proposed resolution

Add an advice to the README.md

Feature request
Status

Fixed

Version

2.0

Component

Documentation

Created by

🇩🇪Germany osopolar 🇩🇪 GER 🌐

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024