Manual.rst: add sendEmail.pl tls=no

extension/Documentation/Manual.rst

@@ -226,36 +226,34 @@ Setup a *report* to manage all *forms*:
 * Create a Typo3 page.
 * Set the 'URL Alias' to `form` (default) or the individual defined value in parameter `editFormPage` (configuration_).
 * Insert a content record of type *qfq*.
-* In the bodytext insert the following code:
+* In the bodytext insert the following code: ::
 
-::
+    # If there is a form given by SIP: show
+    form={{form:SE}}
 
-	# If there is a form given by SIP: show
-	form={{form:SE}}
+    # In case indexQfq is different from indexData, set indexQfq.
+    dbIndex = {{indexQfq:Y}}
 
-	# In case indexQfq is different from indexData, set indexQfq.
-	dbIndex = {{indexQfq:Y}}
+    10 {
+        # List of Forms: Do not show this list of forms if there is a form given by SIP.
+        # Table header.
+        sql = SELECT CONCAT('p:{{pageId:T}}&form=form') as _pagen, '#', 'Name', 'Title', 'Table', '' FROM (SELECT 1) AS fake WHERE '{{form:SE}}'=''
+        head = <table class="table table-hover qfq-table-50">
+        tail = </table>
+        rbeg = <thead><tr>
+        rend = </tr></thead>
+        fbeg = <th>
+        fend = </th>
 
-	10 {
-		# List of Forms: Do not show this list of forms if there is a form given by SIP.
-		# Table header.
-		sql = SELECT CONCAT('p:{{pageId:T}}&form=form') as _pagen, '#', 'Name', 'Title', 'Table', '' FROM (SELECT 1) AS fake WHERE '{{form:SE}}'=''
-		head = <table class="table table-hover qfq-table-50">
-		tail = </table>
-		rbeg = <thead><tr>
-		rend = </tr></thead>
-		fbeg = <th>
-		fend = </th>
-
-		10 {
-			# All forms
-			sql = SELECT CONCAT('p:{{pageId:T}}&form=form&r=', f.id) as _pagee, f.id, f.name, f.title, f.tableName, CONCAT('form=form&r=', f.id) as _Paged FROM Form AS f ORDER BY f.name
-			rbeg = <tr>
-			rend = </tr>
-			fbeg = <td>
-			fend = </td>
-		}
-	}
+        10 {
+            # All forms
+            sql = SELECT CONCAT('p:{{pageId:T}}&form=form&r=', f.id) as _pagee, f.id, f.name, f.title, f.tableName, CONCAT('form=form&r=', f.id) as _Paged FROM Form AS f ORDER BY f.name
+            rbeg = <tr>
+            rend = </tr>
+            fbeg = <td>
+            fend = </td>
+        }
+    }
 
 .. _install-checklist:
 
@@ -456,35 +454,39 @@ config.qfq.php
 
 
 
-Example: *typo3conf/config.qfq.php*
+Example: *typo3conf/config.qfq.php*: ::
 
-::
+    <?php
 
-	; QFQ configuration
-	;
-	; Save this file as: <site path>/typo3conf/config.qfq.php
+    // QFQ configuration
+    //
+    // Save this file as: <site path>/typo3conf/config.qfq.php
 
-	DB_1_USER = <DBUSER>
-	DB_1_SERVER = <DBSERVER>
-	DB_1_PASSWORD = <DBPW>
-	DB_1_NAME = <DB>
+    return [
+        'DB_1_USER' => '<DBUSER>',
+        'DB_1_SERVER' => '<DBSERVER>',
+        'DB_1_PASSWORD' => '<DBPW>',
+        'DB_1_NAME' => '<DB>',
 
-	; DB_2_USER = <DBUSER>
-	; DB_2_SERVER = <DBSERVER>
-	; DB_2_PASSWORD = <DBPW>
-	; DB_2_NAME = <DB>
+        //DB_2_USER = <DBUSER>
+        //DB_2_SERVER = <DBSERVER>
+        //DB_2_PASSWORD = <DBPW>
+        //DB_2_NAME = <DB>
 
-	; LDAP_1_RDN =
-	; LDAP_1_PASSWORD =
+        // DB_n ...
+        // ...
 
+        // LDAP_1_RDN =
+        // LDAP_1_PASSWORD =
+    ];
 
 After parsing the configuration, the following variables will be set automatically in STORE_SYSTEM:
 
-+----------------+--------------------------------------------------------------------------+
-| _dbNameData    | Can be used to dynamically access the current selected database          |
-+----------------+--------------------------------------------------------------------------+
-| _dbNameQfq     | Can be used to dynamically access the current selected database          |
-+----------------+--------------------------------------------------------------------------+
++----------------+-----------------------------------------------------------------------------------+
+| _dbNameData    | Can be used to dynamically access the current selected database: {{dbNameData:Y}} |
++----------------+-----------------------------------------------------------------------------------+
+| _dbNameQfq     | Can be used to dynamically access the current selected database: {{dbNameQfq:Y}}  |
++----------------+-----------------------------------------------------------------------------------+
 
 .. _`CustomVariables`:
 
@@ -503,6 +505,8 @@ E.g. to setup a contact address and reuse the information inside your installati
 
       {{ADMINISTRATIVE_CONTACT:Y}}, {{ADMINISTRATIVE_ADDRESS:Y}}, {{ADMINISTRATIVE_NAME}}
 
+It's also possible to configure such variables directly in `config.qfq.php`_.
+
 .. _`fillStoreSystemBySql`:
 
 Fill STORE_SYSTEM by SQL
@@ -536,7 +540,7 @@ After a full QFQ installation:
 * a table `Period` (extend / change it to your needs, fill them with your periods),
 * one sample record in table `Period`,
 
-Websites, delivering semester data, schoolyears schedules, or any other type or periods, often need an index to the
+Websites, delivering semester data, school year schedules, or any other type or periods, often need an index to the
 *current* period.
 
 In configuration_: ::
@@ -6931,6 +6935,13 @@ a more detailed message.
 The error might occur if there are problematic characters in config.qfq.php, like single or double ticks inside strings,
  wich are not enclosed (correctly).
 
+sendEmail: Error => TLS setup failed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Switch off the TLS encryption. In `configuration`_ specify for *config.sendEMailOptions*: ::
+
+   -o tls=no
+
 .. _`javascriptProblem`:
 
 Javascript problem

extension/Documentation/Release.rst

@@ -74,11 +74,11 @@ Features
 Bug Fixes
 ^^^^^^^^^
 
-* #5077 / Dynamic Update & FE.type=required: Server fixed -
+ * #5077 / Dynamic Update & FE.type=required: Server fixed -
 
-  a) dynamic calculated modeSql respected,
-  b) formModeGlobal=requiredOff respected,
-  c) dynamic FE with mode='hidden' are not saved anymore.
+    a) dynamic calculated modeSql respected,
+    b) formModeGlobal=requiredOff respected,
+    c) dynamic FE with mode='hidden' are not saved anymore.
 
  * #6176 / Icon not aligned when error text: Buttons now wrapped in one 'input-group'.
  * Manual.rst: reformat autocron QFQ code