From ff29d0575484d6f56fa962235a066e4d69bb8bf2 Mon Sep 17 00:00:00 2001 From: Bozana Bokan Date: Wed, 17 Jun 2026 15:56:02 +0200 Subject: [PATCH] pkp/pkp-lib#7527 Stamp press identity metadata onto publications --- api/v1/submissions/SubmissionController.php | 2 +- .../forms/publication/CatalogEntryForm.php | 42 ++- .../upgrade/v3_6_0/I7527_IdentityMetadata.php | 41 +++ .../HasContextIdentityMetadata.php | 47 +++ classes/publication/Publication.php | 24 ++ dbscripts/xml/upgrade.xml | 1 + locale/en/manager.po | 3 + locale/en/submission.po | 6 + pages/workflow/WorkflowHandler.php | 2 +- .../googleScholar/GoogleScholarPlugin.php | 2 +- .../filter/NativeXmlPublicationFilter.php | 3 + .../filter/PublicationNativeXmlFilter.php | 10 + plugins/importexport/native/native.xsd | 4 + .../filter/MonographONIX30XmlFilter.php | 8 +- .../Dc11SchemaPublicationFormatAdapter.php | 6 +- schemas/publication.json | 35 ++- tools/stampIdentityMetadata.php | 279 ++++++++++++++++++ 17 files changed, 494 insertions(+), 21 deletions(-) create mode 100644 classes/migration/upgrade/v3_6_0/I7527_IdentityMetadata.php create mode 100644 classes/publication/HasContextIdentityMetadata.php create mode 100644 tools/stampIdentityMetadata.php diff --git a/api/v1/submissions/SubmissionController.php b/api/v1/submissions/SubmissionController.php index 9df3223f800..b349015d807 100644 --- a/api/v1/submissions/SubmissionController.php +++ b/api/v1/submissions/SubmissionController.php @@ -105,7 +105,7 @@ protected function getCatalogEntryForm(Request $illuminateRequest): JsonResponse $publicFileManager = new PublicFileManager(); $baseUrl = $request->getBaseUrl() . '/' . $publicFileManager->getContextFilesPath($context->getId()); - $catalogEntryForm = new CatalogEntryForm($publicationApiUrl, $locales, $publication, $submission, $baseUrl, $temporaryFileApiUrl); + $catalogEntryForm = new CatalogEntryForm($publicationApiUrl, $locales, $publication, $submission, $baseUrl, $temporaryFileApiUrl, $context); $submissionLocale = $submission->getData('locale'); return response()->json($this->getLocalizedForm($catalogEntryForm, $submissionLocale, $locales), Response::HTTP_OK); diff --git a/classes/components/forms/publication/CatalogEntryForm.php b/classes/components/forms/publication/CatalogEntryForm.php index c785a22a700..f3a526bd395 100644 --- a/classes/components/forms/publication/CatalogEntryForm.php +++ b/classes/components/forms/publication/CatalogEntryForm.php @@ -18,9 +18,11 @@ namespace APP\components\forms\publication; use APP\facades\Repo; +use APP\press\Press; use APP\publication\Publication; use APP\submission\Submission; use PKP\components\forms\FieldAutosuggestPreset; +use PKP\components\forms\FieldHTML; use PKP\components\forms\FieldRichTextarea; use PKP\components\forms\FieldSelect; use PKP\components\forms\FieldText; @@ -37,6 +39,7 @@ class CatalogEntryForm extends FormComponent public const GROUP_VERSION_AND_UPDATES = 'versionAndUpdates'; public const GROUP_DISPLAY = 'display'; public const GROUP_ACCESS = 'access'; + public const GROUP_PRESS_IDENTITY = 'pressIdentity'; public $id = self::FORM_CATALOG_ENTRY; public $method = 'PUT'; @@ -53,8 +56,9 @@ class CatalogEntryForm extends FormComponent * @param Submission $submission The submission of this publication * @param string $baseUrl Site's base URL. Used for image previews. * @param string $temporaryFileApiUrl The url to upload the cover image + * @param Press $press The press this publication belongs to */ - public function __construct($action, $locales, $publication, $submission, $baseUrl, $temporaryFileApiUrl) + public function __construct($action, $locales, $publication, $submission, $baseUrl, $temporaryFileApiUrl, ?Press $press = null) { $this->action = $action; $this->successMessage = __('publication.catalogEntry.success'); @@ -172,5 +176,41 @@ public function __construct($action, $locales, $publication, $submission, $baseU 'description' => __('publication.urlPath.description'), 'value' => $publication->getData('urlPath'), ])); + + if ($press) { + $this->addStampedIdentityField($publication, $press); + } + } + + protected function addStampedIdentityField(Publication $publication, Press $press): void + { + $parts = []; + + if ($publication->getData('contextName')) { + $parts[] = '
  • ' . htmlspecialchars(__('manager.setup.contextTitle')) . ': ' + . htmlspecialchars($publication->getPrimaryContextName($press)) . '
    • '; + } + if ($publisher = $publication->getData('publisher')) { + $parts[] = '
  • ' . htmlspecialchars(__('manager.setup.publisher')) . ': ' + . htmlspecialchars($publisher) . '
    • '; + } + if ($publisherLocation = $publication->getData('publisherLocation')) { + $parts[] = '
  • ' . htmlspecialchars(__('manager.setup.publisherLocation')) . ': ' + . htmlspecialchars($publisherLocation) . '
    • '; + } + + if (empty($parts)) { + return; + } + + $this->addGroup( + ['id' => self::GROUP_PRESS_IDENTITY, 'label' => __('publication.pressIdentity')] + ); + $this->addField(new FieldHTML('pressIdentity', [ + 'groupId' => self::GROUP_PRESS_IDENTITY, + 'label' => __('publication.pressIdentity'), + 'description' => __('publication.pressIdentity.description') + . '', + ])); } } diff --git a/classes/migration/upgrade/v3_6_0/I7527_IdentityMetadata.php b/classes/migration/upgrade/v3_6_0/I7527_IdentityMetadata.php new file mode 100644 index 00000000000..5aadd08c009 --- /dev/null +++ b/classes/migration/upgrade/v3_6_0/I7527_IdentityMetadata.php @@ -0,0 +1,41 @@ + 'publisherLocation']; + $rows = DB::table($settingsTable) + ->where($idColumn, $contextId) + ->whereIn('setting_name', ['publisher', 'codeType', 'codeValue', 'location']) + ->where('setting_value', '!=', '') + ->pluck('setting_value', 'setting_name'); + + foreach ($rows as $name => $value) { + $settings[$rename[$name] ?? $name] = $value; + } + + return $settings; + } +} diff --git a/classes/publication/HasContextIdentityMetadata.php b/classes/publication/HasContextIdentityMetadata.php new file mode 100644 index 00000000000..65c8b10a9be --- /dev/null +++ b/classes/publication/HasContextIdentityMetadata.php @@ -0,0 +1,47 @@ +getData('publisher') ?: $context->getData('publisher'); + } + + /** + * Get the stamped publisher code type, falling back to the live context value. + */ + public function getCodeType(Context $context): ?string + { + return $this->getData('codeType') ?: $context->getData('codeType'); + } + + /** + * Get the stamped publisher code value, falling back to the live context value. + */ + public function getCodeValue(Context $context): ?string + { + return $this->getData('codeValue') ?: $context->getData('codeValue'); + } +} diff --git a/classes/publication/Publication.php b/classes/publication/Publication.php index 00f503d040e..3fe28c5500d 100644 --- a/classes/publication/Publication.php +++ b/classes/publication/Publication.php @@ -22,10 +22,13 @@ use APP\facades\Repo; use APP\file\PublicFileManager; use APP\publication\enums\VersionStage; +use PKP\context\Context; use PKP\publication\PKPPublication; class Publication extends PKPPublication { + use HasContextIdentityMetadata; + public const DEFAULT_VERSION_STAGE = VersionStage::VERSION_OF_RECORD; /** @@ -111,4 +114,25 @@ public function getLocalizedCoverImageThumbnailUrl(int $contextId) Repo::publication()->getThumbnailFilename($pathParts['basename']), ]); } + + /** + * Stamp press identity onto the publication. + */ + public function stampContextIdentity(?Context $context = null): void + { + $context ??= $this->getStampingContext(); + parent::stampContextIdentity($context); + $this->setData('publisher', $context->getData('publisher')); + $this->setData('publisherLocation', $context->getData('location')); + $this->setData('codeType', $context->getData('codeType')); + $this->setData('codeValue', $context->getData('codeValue')); + } + + public function clearIdentityMetadata(): void + { + parent::clearIdentityMetadata(); + $this->setData('publisher', null); + $this->setData('codeType', null); + $this->setData('codeValue', null); + } } diff --git a/dbscripts/xml/upgrade.xml b/dbscripts/xml/upgrade.xml index 978d9540178..b8f14ebab53 100644 --- a/dbscripts/xml/upgrade.xml +++ b/dbscripts/xml/upgrade.xml @@ -211,6 +211,7 @@ + diff --git a/locale/en/manager.po b/locale/en/manager.po index 15557bd3ead..18ba1aeef5b 100644 --- a/locale/en/manager.po +++ b/locale/en/manager.po @@ -731,6 +731,9 @@ msgstr "Publisher" msgid "manager.setup.publisherDescription" msgstr "The name of the organization publishing the press will appear in About the Press." +msgid "manager.setup.publisherLocation" +msgstr "Publisher Location" + msgid "manager.setup.referenceLinking" msgstr "Reference Linking" diff --git a/locale/en/submission.po b/locale/en/submission.po index 0ed6d8d09d1..54044da8493 100644 --- a/locale/en/submission.po +++ b/locale/en/submission.po @@ -339,6 +339,12 @@ msgstr "Catalog Entry" msgid "publication.catalogEntry.success" msgstr "The catalog entry details have been updated." +msgid "publication.pressIdentity" +msgstr "Press Identity" + +msgid "publication.pressIdentity.description" +msgstr "This metadata was recorded when the publication was published and will not change if the press updates its identity settings." + msgid "publication.invalidSeries" msgstr "The series for this publication could not be found." diff --git a/pages/workflow/WorkflowHandler.php b/pages/workflow/WorkflowHandler.php index 5c3fd934be2..bc5e9828e4b 100644 --- a/pages/workflow/WorkflowHandler.php +++ b/pages/workflow/WorkflowHandler.php @@ -113,7 +113,7 @@ public function setupIndex($request) $baseUrl = $request->getBaseUrl() . '/' . $publicFileManager->getContextFilesPath($submissionContext->getId()); $audienceForm = new \APP\components\forms\submission\AudienceForm($submissionApiUrl, $submission); - $catalogEntryForm = new \APP\components\forms\publication\CatalogEntryForm($latestPublicationApiUrl, $locales, $latestPublication, $submission, $baseUrl, $temporaryFileApiUrl); + $catalogEntryForm = new \APP\components\forms\publication\CatalogEntryForm($latestPublicationApiUrl, $locales, $latestPublication, $submission, $baseUrl, $temporaryFileApiUrl, $submissionContext); $publicationDatesForm = new \APP\components\forms\submission\PublicationDatesForm($submissionApiUrl, $submission); $publicationLicenseForm = new \APP\components\forms\publication\PublicationLicenseForm($latestPublicationApiUrl, $locales, $latestPublication, $submissionContext); diff --git a/plugins/generic/googleScholar/GoogleScholarPlugin.php b/plugins/generic/googleScholar/GoogleScholarPlugin.php index 04e097ec24b..9bdd0bd8ebd 100644 --- a/plugins/generic/googleScholar/GoogleScholarPlugin.php +++ b/plugins/generic/googleScholar/GoogleScholarPlugin.php @@ -169,7 +169,7 @@ public function monographView($hookName, $args) } // Publisher - $templateMgr->addHeader('googleScholarPublisher', ''); + $templateMgr->addHeader('googleScholarPublisher', ''); // Series ISSN (online) if ($series && $issn = $series->getOnlineISSN()) { diff --git a/plugins/importexport/native/filter/NativeXmlPublicationFilter.php b/plugins/importexport/native/filter/NativeXmlPublicationFilter.php index 578fc021c7d..4ea11cfbf38 100644 --- a/plugins/importexport/native/filter/NativeXmlPublicationFilter.php +++ b/plugins/importexport/native/filter/NativeXmlPublicationFilter.php @@ -62,6 +62,9 @@ public function handleChildElement($n, $publication) $nativeFilterHelper->parsePublicationCovers($this, $n, $publication), ], 'series' => $this->parseSeries($this, $n, $publication), + 'publisher' => $publication->setData('publisher', $n->textContent), + 'codeType' => $publication->setData('codeType', $n->textContent), + 'codeValue' => $publication->setData('codeValue', $n->textContent), default => parent::handleChildElement($n, $publication) }; } diff --git a/plugins/importexport/native/filter/PublicationNativeXmlFilter.php b/plugins/importexport/native/filter/PublicationNativeXmlFilter.php index 1d6a8f65f62..8d29fb594c2 100644 --- a/plugins/importexport/native/filter/PublicationNativeXmlFilter.php +++ b/plugins/importexport/native/filter/PublicationNativeXmlFilter.php @@ -66,6 +66,16 @@ public function createEntityNode($doc, $entity) $this->addChapters($doc, $entityNode, $entity); } + if ($publisher = $entity->getData('publisher')) { + $entityNode->appendChild($doc->createElementNS($deployment->getNamespace(), 'publisher', htmlspecialchars($publisher, ENT_COMPAT, 'UTF-8'))); + } + if ($codeType = $entity->getData('codeType')) { + $entityNode->appendChild($doc->createElementNS($deployment->getNamespace(), 'codeType', htmlspecialchars($codeType, ENT_COMPAT, 'UTF-8'))); + } + if ($codeValue = $entity->getData('codeValue')) { + $entityNode->appendChild($doc->createElementNS($deployment->getNamespace(), 'codeValue', htmlspecialchars($codeValue, ENT_COMPAT, 'UTF-8'))); + } + // cover images $nativeFilterHelper = new PKPNativeFilterHelper(); $coversNode = $nativeFilterHelper->createPublicationCoversNode($this, $doc, $entity); diff --git a/plugins/importexport/native/native.xsd b/plugins/importexport/native/native.xsd index c5b5e1ddf68..4dfc5373429 100644 --- a/plugins/importexport/native/native.xsd +++ b/plugins/importexport/native/native.xsd @@ -99,6 +99,10 @@ + + + + diff --git a/plugins/importexport/onix30/filter/MonographONIX30XmlFilter.php b/plugins/importexport/onix30/filter/MonographONIX30XmlFilter.php index 9ce6e1ed387..cfb7a742b4e 100644 --- a/plugins/importexport/onix30/filter/MonographONIX30XmlFilter.php +++ b/plugins/importexport/onix30/filter/MonographONIX30XmlFilter.php @@ -565,7 +565,7 @@ public function createProductNode(DOMDocument $doc, Submission $submission, Publ $publishingDetailNode->appendChild($publisherNode); $publisherNode->appendChild($this->buildTextNode($doc, 'PublishingRole', '01')); // Publisher - $publisherNode->appendChild($this->buildTextNode($doc, 'PublisherName', $context->getData('publisher'))); + $publisherNode->appendChild($this->buildTextNode($doc, 'PublisherName', $publication->getPublisher($context))); $websiteNode = $doc->createElementNS($deployment->getNamespace(), 'Website'); $publisherNode->appendChild($websiteNode); @@ -612,8 +612,8 @@ public function createProductNode(DOMDocument $doc, Submission $submission, Publ } } - if ($context->getData('location') != '') { - $publishingDetailNode->appendChild($this->buildTextNode($doc, 'CityOfPublication', $context->getData('location'))); + if ($publisherLocation = $publication->getData('publisherLocation') ?: $context->getData('location')) { + $publishingDetailNode->appendChild($this->buildTextNode($doc, 'CityOfPublication', $publisherLocation)); } /* --- Publishing Dates --- */ @@ -838,7 +838,7 @@ public function createProductNode(DOMDocument $doc, Submission $submission, Publ $supplierWebsiteNode->appendChild($this->buildTextNode($doc, 'WebsiteLink', $request->url($context->getPath(), 'catalog', 'book', [$submissionBestId]))); } else { // No suppliers specified, use the Press settings instead. $supplierNode->appendChild($this->buildTextNode($doc, 'SupplierRole', '09')); // Publisher supplying to end customers - $supplierNode->appendChild($this->buildTextNode($doc, 'SupplierName', $context->getData('publisher'))); + $supplierNode->appendChild($this->buildTextNode($doc, 'SupplierName', $publication->getPublisher($context))); if ($context->getData('contactEmail') != '') { $supplierNode->appendChild($this->buildTextNode($doc, 'EmailAddress', $context->getData('contactEmail'))); diff --git a/plugins/metadata/dc11/filter/Dc11SchemaPublicationFormatAdapter.php b/plugins/metadata/dc11/filter/Dc11SchemaPublicationFormatAdapter.php index 2de2b99704b..6507ec77979 100755 --- a/plugins/metadata/dc11/filter/Dc11SchemaPublicationFormatAdapter.php +++ b/plugins/metadata/dc11/filter/Dc11SchemaPublicationFormatAdapter.php @@ -111,11 +111,11 @@ public function extractMetadataFromDataObject(&$publicationFormat) $this->_addLocalizedElements($dc11Description, 'dc:description', $publication->getData('abstract')); // Publisher - $publisher = $press->getSetting('publisher'); + $publisher = $publication->getPublisher($press); if (!empty($publisher)) { $publishers = [$press->getPrimaryLocale() => $publisher]; } else { - $publishers = $press->getName(null); // Default + $publishers = $publication->getData('contextName', null) ?: $press->getName(null); // Default } $this->_addLocalizedElements($dc11Description, 'dc:publisher', $publishers); @@ -195,7 +195,7 @@ public function extractMetadataFromDataObject(&$publicationFormat) } // Source (press title and pages) - $sources = $press->getName(null); + $sources = $publication->getData('contextName') ?: $press->getName(null); $pages = $publication->getData('pages'); if (!empty($pages)) { $pages = '; ' . $pages; diff --git a/schemas/publication.json b/schemas/publication.json index 2a65940b65c..2ddcc4bcac3 100644 --- a/schemas/publication.json +++ b/schemas/publication.json @@ -3,13 +3,13 @@ "description": "A published version of a monograph.", "type": "object", "properties": { - "status": { - "type": "integer", - "description": "Whether the publication is Queued (not yet scheduled for publication), Declined, Published or Scheduled (scheduled for publication at a future date). One of the `PKPPublication::STATUS_*` constants. Default is `PKPPublication::STATUS_QUEUED`.", + "chapterLicenseUrl": { + "type": "string", + "description": "A URL to a webpage describing the default license terms for chapters of this publication.", "apiSummary": true, - "default": 1, "validation": [ - "in:1,3,4,5" + "nullable", + "url" ] }, "chapters": { @@ -21,11 +21,26 @@ "$ref": "#/definitions/Chapter" } }, + "codeType": { + "type": "string", + "writeDisabledInApi": true, + "validation": ["nullable"] + }, + "codeValue": { + "type": "string", + "writeDisabledInApi": true, + "validation": ["nullable"] + }, "publicationFormats": { "type": "array", "apiSummary": true, "readOnly": true }, + "publisher": { + "type": "string", + "writeDisabledInApi": true, + "validation": ["nullable"] + }, "seriesId": { "type": "integer", "description": "The id of the series this publication appears in.", @@ -42,13 +57,13 @@ "nullable" ] }, - "chapterLicenseUrl": { - "type": "string", - "description": "A URL to a webpage describing the default license terms for chapters of this publication.", + "status": { + "type": "integer", + "description": "Whether the publication is Queued (not yet scheduled for publication), Declined, Published or Scheduled (scheduled for publication at a future date). One of the `PKPPublication::STATUS_*` constants. Default is `PKPPublication::STATUS_QUEUED`.", "apiSummary": true, + "default": 1, "validation": [ - "nullable", - "url" + "in:1,3,4,5" ] } } diff --git a/tools/stampIdentityMetadata.php b/tools/stampIdentityMetadata.php new file mode 100644 index 00000000000..327665a1811 --- /dev/null +++ b/tools/stampIdentityMetadata.php @@ -0,0 +1,279 @@ + 'Old Press Name', 'fr' => 'Ancien nom de presse'] + * + * @var array|null + */ + public ?array $contextNameOverride = null; + + /** @var string|null Publisher name, e.g. 'Old Publisher Name' */ + public ?string $publisherOverride = null; + + /** @var string|null Publisher location (city), e.g. 'Berlin' */ + public ?string $publisherLocationOverride = null; + + /** @var string|null Publisher code type */ + public ?string $codeTypeOverride = null; + + /** @var string|null Publisher code value */ + public ?string $codeValueOverride = null; + + // ========================================================================= + + public int $contextId; + public string $command; + public array $parameters; + + /** + * Constructor. + * + * @param array $argv command-line arguments + */ + public function __construct($argv = []) + { + parent::__construct($argv); + if (count($this->argv) < 2) { + $this->usage(); + exit(); + } + $this->contextId = (int)array_shift($this->argv); + $this->command = array_shift($this->argv); + $this->parameters = $this->argv; + } + + /** + * Print command usage information. + */ + public function usage() + { + echo "Re-stamps press identity metadata (name, publisher) onto publications\n" + . "from the press's current settings.\n" + . "To stamp with different values, edit the override variables at the top of this file.\n" + . "Usage:\n" + . "\t{$this->scriptName} submission_id [ ...]\n" + . "\t{$this->scriptName} year [ ...]\n" + . "\t{$this->scriptName} all\n" + . "Year ranges are specified as YYYY-YYYY, e.g. 2010-2020.\n" + . "Use 'all' to stamp everything: all published publications in the press.\n"; + } + + /** + * Re-stamp identity metadata on the targeted publications. + */ + public function execute() + { + /** @var PressDAO $contextDao */ + $contextDao = Application::getContextDAO(); + /** @var Press $context */ + $context = $contextDao->getById($this->contextId); + if (!$context) { + printf("Error: Unknown context ID %d.\n", $this->contextId); + exit(1); + } + + if ($this->command === 'all') { + $this->stampAll($context); + return; + } + + if ($this->command === 'submission_id') { + $submissionIds = array_map('intval', $this->parameters); + if (empty($submissionIds)) { + echo "Error: No submission IDs provided.\n"; + $this->usage(); + exit(1); + } + foreach ($submissionIds as $submissionId) { + $this->stampSubmission($submissionId, $context); + } + return; + } + + if ($this->command === 'year') { + $years = $this->parseYears($this->parameters); + if (empty($years)) { + echo "Error: No valid years or year ranges provided.\n"; + exit(1); + } + $this->stampByYear($context, $years); + return; + } + + printf("Error: Unknown command '%s'. Expected 'submission_id', 'year', or 'all'.\n", $this->command); + $this->usage(); + exit(1); + } + + /** + * Stamp all published publications in the press. + */ + protected function stampAll(Press $context): void + { + $count = 0; + $submissions = Repo::submission()->getCollector() + ->filterByContextIds([$this->contextId]) + ->getMany(); + + foreach ($submissions as $submission) { + $count += $this->stampPublications($submission->getId(), $context); + } + + printf("Stamped %d publication(s) in total.\n", $count); + } + + /** + * Stamp all published publications of a single submission. + */ + protected function stampSubmission(int $submissionId, Press $context): void + { + $submission = Repo::submission()->get($submissionId, $this->contextId); + if (!$submission) { + printf("Error: Skipping submission %d — unknown or does not belong to context %d.\n", $submissionId, $this->contextId); + return; + } + + $count = $this->stampPublications($submissionId, $context); + printf("Stamped %d publication(s) for submission %d.\n", $count, $submissionId); + } + + /** + * Stamp publications published in the given years. + */ + protected function stampByYear(Press $context, array $years): void + { + $count = 0; + $submissions = Repo::submission()->getCollector() + ->filterByContextIds([$this->contextId]) + ->getMany(); + + foreach ($submissions as $submission) { + $publications = Repo::publication()->getCollector() + ->filterBySubmissionIds([$submission->getId()]) + ->getMany(); + + foreach ($publications as $publication) { + $datePublished = $publication->getData('datePublished'); + if (!$datePublished || !in_array((int) date('Y', strtotime($datePublished)), $years)) { + continue; + } + $publication->stampContextIdentity($context); + $this->applyOverrides($publication); + Repo::publication()->edit($publication, []); + $count++; + } + } + + if ($count > 0) { + printf("Stamped %d publication(s) published in the given year(s).\n", $count); + } else { + echo "No publications found published in the given year(s).\n"; + } + } + + /** + * Stamp all publications of a submission, returning the count stamped. + */ + protected function stampPublications(int $submissionId, Press $context): int + { + $count = 0; + $publications = Repo::publication()->getCollector() + ->filterBySubmissionIds([$submissionId]) + ->getMany(); + + foreach ($publications as $publication) { + $publication->stampContextIdentity($context); + $this->applyOverrides($publication); + Repo::publication()->edit($publication, []); + $count++; + } + + return $count; + } + + /** + * Apply any user-specified overrides to a publication after stampContextIdentity(). + * Only non-null overrides are applied; null means "use whatever stampContextIdentity() set". + */ + protected function applyOverrides(object $object): void + { + if ($this->contextNameOverride !== null) { + foreach ($this->contextNameOverride as $locale => $name) { + $object->setData('contextName', $name, $locale); + } + } + if ($this->publisherOverride !== null) { + $object->setData('publisher', $this->publisherOverride); + } + if ($this->publisherLocationOverride !== null) { + $object->setData('publisherLocation', $this->publisherLocationOverride); + } + if ($this->codeTypeOverride !== null) { + $object->setData('codeType', $this->codeTypeOverride); + } + if ($this->codeValueOverride !== null) { + $object->setData('codeValue', $this->codeValueOverride); + } + } + + /** + * Parse a list of year strings (e.g. '2010', '2015-2020') into a flat array of integers. + */ + protected function parseYears(array $params): array + { + $years = []; + foreach ($params as $param) { + if (str_contains($param, '-')) { + [$start, $end] = explode('-', $param, 2); + if (strlen($start) === 4 && ctype_digit($start) && strlen($end) === 4 && ctype_digit($end)) { + foreach (range((int)$start, (int)$end) as $year) { + $years[$year] = true; + } + } else { + printf("Warning: Skipping invalid year range '%s'.\n", $param); + } + } elseif (strlen($param) === 4 && ctype_digit($param)) { + $years[(int)$param] = true; + } else { + printf("Warning: Skipping invalid year '%s'.\n", $param); + } + } + return array_keys($years); + } +} + +$tool = new StampPressIdentityMetadata($argv ?? []); +$tool->execute();