Warn users to request RePEc archive codes

diegoabadan · diegoabadan · commit cc3b3ba94b63 · 2026-05-19T11:58:43.000-03:00
diff --git a/README.md b/README.md
@@ -8,6 +8,22 @@ Translations:
 - [Español](docs/README.es.md)
 - [Português do Brasil](docs/README.pt_BR.md)
 
+## Before You Start
+
+RePEc is intended for Economics literature and related sciences. Before configuring this plugin, make sure that the journal or institution is eligible for RePEc indexing.
+
+Before publishing any RePEc files, follow the official RePEc step-by-step instructions:
+
+https://ideas.repec.org/stepbystep.html
+
+The step-by-step guide explains how to request an archive code and how to prepare a RePEc archive. For the archive code request step, see also:
+
+https://ideas.repec.org/t/archivehandle.html
+
+Do not invent a RePEc archive code, and do not use a code that belongs to another institution. Every RePEc archive code must be requested from RePEc and assigned to your department or institution to avoid conflicts with archive codes already used by others.
+
+If your institution already has a RePEc archive, you usually do not need a new archive code. A single RePEc archive can include multiple journals or series.
+
 ## Usage
 
 The plugin can be used in two ways:
@@ -20,7 +36,7 @@ These modes can coexist in the same OJS installation. A journal selected for the
 For an individual journal archive:
 
 1. Enable the plugin for a journal.
-2. Open the plugin settings and enter the RePEc archive code, the series code, and the optional maintainer email.
+2. Open the plugin settings and enter the RePEc archive code assigned by RePEc, the series code, and the optional maintainer email.
 3. Access the public URL shown in the plugin settings.
 
 The settings form keeps the required fields separate from advanced options. For most journals, fill in only the RePEc archive code, the series code, and the maintainer email if needed.
diff --git a/docs/README.es.md b/docs/README.es.md
@@ -8,6 +8,22 @@ Traducciones:
 - [Español](README.es.md)
 - [Português do Brasil](README.pt_BR.md)
 
+## Antes de empezar
+
+RePEc está destinado a la literatura de Economía y ciencias relacionadas. Antes de configurar este plugin, confirme que la revista o institución es adecuada para la indexación en RePEc.
+
+Antes de publicar cualquier archivo RePEc, siga las instrucciones oficiales paso a paso de RePEc:
+
+https://ideas.repec.org/stepbystep.html
+
+La guía paso a paso explica cómo solicitar un código de archivo y cómo preparar un archivo RePEc. Para la etapa específica de solicitud del código de archivo, vea también:
+
+https://ideas.repec.org/t/archivehandle.html
+
+No invente un código de archivo RePEc ni use un código perteneciente a otra institución. Todo código de archivo RePEc debe solicitarse a RePEc y ser asignado a su departamento o institución para evitar conflictos con códigos ya usados por terceros.
+
+Si su institución ya tiene un archivo RePEc, normalmente no es necesario solicitar un nuevo código de archivo. Un único archivo RePEc puede incluir varias revistas o series.
+
 ## Uso
 
 El plugin puede usarse de dos formas:
@@ -20,7 +36,7 @@ Estos modos pueden coexistir en la misma instalación OJS. Una revista seleccion
 Para un archivo individual de revista:
 
 1. Active el plugin en una revista.
-2. Abra la configuración del plugin e informe el código RePEc del archivo, el código de la serie y el correo electrónico opcional del mantenedor.
+2. Abra la configuración del plugin e informe el código de archivo asignado por RePEc, el código de la serie y el correo electrónico opcional del mantenedor.
 3. Acceda a la URL pública indicada en la configuración del plugin.
 
 El formulario separa los campos obligatorios de las opciones avanzadas. Para la mayoría de las revistas, complete solo el código del archivo RePEc, el código de la serie y, si es necesario, el correo electrónico del mantenedor.
diff --git a/docs/README.pt_BR.md b/docs/README.pt_BR.md
@@ -8,6 +8,22 @@ Traduções:
 - [Español](README.es.md)
 - [Português do Brasil](README.pt_BR.md)
 
+## Antes de começar
+
+O RePEc é voltado à literatura de Economia e ciências relacionadas. Antes de configurar este plugin, confirme que a revista ou instituição é adequada para indexação no RePEc.
+
+Antes de publicar qualquer arquivo RePEc, siga as instruções oficiais passo a passo do RePEc:
+
+https://ideas.repec.org/stepbystep.html
+
+O guia passo a passo explica como solicitar um código de arquivo e como preparar um arquivo RePEc. Para a etapa específica de solicitação do código de arquivo, veja também:
+
+https://ideas.repec.org/t/archivehandle.html
+
+Não invente um código de arquivo RePEc nem use um código pertencente a outra instituição. Todo código de arquivo RePEc deve ser solicitado ao RePEc e atribuído ao seu departamento ou instituição para evitar conflitos com códigos já usados por terceiros.
+
+Se a sua instituição já tem um arquivo RePEc, normalmente não é necessário solicitar um novo código de arquivo. Um único arquivo RePEc pode incluir várias revistas ou séries.
+
 ## Uso
 
 O plugin pode ser usado de duas formas:
@@ -20,7 +36,7 @@ Esses modos podem coexistir na mesma instalação OJS. Uma revista selecionada p
 Para um arquivo individual de revista:
 
 1. Habilite o plugin em uma revista.
-2. Abra as configurações do plugin e informe o código RePEc do arquivo, o código da série e o e-mail opcional do mantenedor.
+2. Abra as configurações do plugin e informe o código de arquivo atribuído pelo RePEc, o código da série e o e-mail opcional do mantenedor.
 3. Acesse a URL pública indicada na configuração do plugin.
 
 O formulário separa os campos obrigatórios das opções avançadas. Para a maioria das revistas, preencha apenas o código do arquivo RePEc, o código da série e, se necessário, o e-mail do mantenedor.
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
@@ -35,8 +35,14 @@ msgstr "Maintainer"
 msgid "plugins.generic.repec.settings.requiredData"
 msgstr "Data required to configure the RePEc plugin"
 
+msgid "plugins.generic.repec.settings.repecScopeNotice"
+msgstr "RePEc is intended for Economics literature and related sciences. Before publishing any RePEc files, follow the official RePEc step-by-step instructions:"
+
 msgid "plugins.generic.repec.settings.archiveCode"
-msgstr "3-letter code provided by RePEc"
+msgstr "Archive code officially assigned by RePEc"
+
+msgid "plugins.generic.repec.settings.archiveCodeDescription"
+msgstr "Do not invent this code, and do not use a code that belongs to another institution. Request the archive code from RePEc before configuring the plugin."
 
 msgid "plugins.generic.repec.settings.archiveName"
 msgstr "Archive name"
diff --git a/locale/es_ES/locale.po b/locale/es_ES/locale.po
@@ -35,8 +35,14 @@ msgstr "Mantenedor"
 msgid "plugins.generic.repec.settings.requiredData"
 msgstr "Datos necesarios para configurar el plugin RePEc"
 
+msgid "plugins.generic.repec.settings.repecScopeNotice"
+msgstr "RePEc está destinado a la literatura de Economía y ciencias relacionadas. Antes de publicar cualquier archivo RePEc, siga las instrucciones oficiales paso a paso de RePEc:"
+
 msgid "plugins.generic.repec.settings.archiveCode"
-msgstr "Código de 3 letras proporcionado por RePEc"
+msgstr "Código de archivo asignado oficialmente por RePEc"
+
+msgid "plugins.generic.repec.settings.archiveCodeDescription"
+msgstr "No invente este código ni use un código perteneciente a otra institución. Solicite el código de archivo a RePEc antes de configurar el plugin."
 
 msgid "plugins.generic.repec.settings.archiveName"
 msgstr "Nombre del archivo"
diff --git a/locale/pt_BR/locale.po b/locale/pt_BR/locale.po
@@ -35,8 +35,14 @@ msgstr "Mantenedor"
 msgid "plugins.generic.repec.settings.requiredData"
 msgstr "Dados necessários para configuração do plugin RePEc"
 
+msgid "plugins.generic.repec.settings.repecScopeNotice"
+msgstr "O RePEc é voltado à literatura de Economia e ciências relacionadas. Antes de publicar qualquer arquivo RePEc, siga as instruções oficiais passo a passo do RePEc:"
+
 msgid "plugins.generic.repec.settings.archiveCode"
-msgstr "Código de 3 letras fornecido pelo RePEc"
+msgstr "Código de arquivo atribuído oficialmente pelo RePEc"
+
+msgid "plugins.generic.repec.settings.archiveCodeDescription"
+msgstr "Não invente este código nem use um código pertencente a outra instituição. Solicite o código de arquivo ao RePEc antes de configurar o plugin."
 
 msgid "plugins.generic.repec.settings.archiveName"
 msgstr "Nome do arquivo"
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
@@ -153,12 +153,17 @@
 	{/if}
 
 	{fbvFormArea id="repecSettings"}
+		<p class="repecSettingsSupportEmailNotice">
+			{translate key="plugins.generic.repec.settings.repecScopeNotice"}
+			<a href="https://ideas.repec.org/stepbystep.html" target="_blank" rel="noopener">https://ideas.repec.org/stepbystep.html</a>
+		</p>
+
 		{if $isManagedByGlobalArchive}
 			<p>{translate key="plugins.generic.repec.settings.managedByGlobalArchive" archiveCode=$globalArchiveCode}</p>
 		{else}
 			{fbvFormSection title="plugins.generic.repec.settings.requiredData"}
 				<div class="repecSettingsFormField">
-					{fbvElement type="text" id="archiveCode" value=$archiveCode required=true label="plugins.generic.repec.settings.archiveCode" maxlength="3"}
+					{fbvElement type="text" id="archiveCode" value=$archiveCode required=true label="plugins.generic.repec.settings.archiveCode" description="plugins.generic.repec.settings.archiveCodeDescription" maxlength="3"}
 				</div>
 				{if !$isGlobalContext}
 					<div class="repecSettingsFormField">
