base: add an help attribute for connectors (#34885)

passerelle/apps/csvdatasource/models.py

@@ -132,6 +132,7 @@ class CsvDataSource(BaseResource):
     sheet_name = models.CharField(_('Sheet name'), blank=True, max_length=150)
 
     category = _('Data Sources')
+    documentation_url = 'https://doc-publik.entrouvert.com/admin-fonctionnel/parametrage-avance/source-de-donnees-csv/'
 
     class Meta:
         verbose_name = _('Spreadsheet File')

passerelle/apps/jsondatastore/models.py

@@ -76,6 +76,7 @@ class JsonData(models.Model):
 
 class JsonDataStore(BaseResource):
     category = _('Data Sources')
+    documentation_url = 'https://doc-publik.entrouvert.com/admin-fonctionnel/parametrage-avance/json-data-store/'
     text_value_template = models.CharField(_('Template for "text" key value'),
             max_length=256, blank=True)
 

passerelle/sms/__init__.py

@@ -9,6 +9,7 @@ from passerelle.utils.jsonresponse import APIError
 
 class SMSGatewayMixin(object):
     category = _('SMS Providers')
+    documentation_url = 'https://doc-publik.entrouvert.com/admin-fonctionnel/les-tutos/configuration-envoi-sms/'
 
     _can_send_messages_description = _('Sending messages is limited to the following API users:')
 

passerelle/templates/passerelle/manage/service_view.html

@@ -50,7 +50,11 @@
 </div>
 
 <div id="endpoints" class="section">
-<h3>{% trans 'Endpoints' %}</h3>
+<h3>{% trans 'Endpoints' %}
+  {% if object.documentation_url %}
+  <a href="{{ object.documentation_url }}">({% trans "documentation" %})</a>
+  {% endif %}
+</h3>
   <div>
   {% if object.api_description %}<p>{{object.api_description}}</p>{% endif %}
   {% block endpoints %}