Differences

This shows you the differences between two versions of the page.

--- res:plugins:fpcaptcha [2025/06/06 23:41] – [Download] fraenkiman
+++ res:plugins:fpcaptcha [2025/06/07 00:37] (current) – [Check PHP Configuration] fraenkiman
@@ Line 15: / Line 15: @@
 {{ :res:plugins:frank:captcha1_2_2.zip |}} | Requires FlatPress 1.4 Notturno or higher
-=== Optionally - Voice output for better accessibility ===
+==== Optionally - Voice output for better accessibility ====
   * [[https://en.wikipedia.org/wiki/ESpeak|eSpeak or eSpeak-NG]] must be installed on the server and located in the system path (calling ''which espeak-ng'' or ''which espeak'' may return a valid path).
   * Optionally, the ''lame'' codec for .mp3 output can also be installed on the web server for better compatibility with visitors' end devices.
   * PHP functions ''exec'' and ''passthru'' (as well as ''shell_exec'', ''system'', ''proc_open'') must not be disabled.
   * No restrictive ''open_basedir'' setting may prevent the execution of eSpeak.
 ==== Demo ====
 [[https://frank-web.dedyn.io|https://frank-web.dedyn.io]]
+==== Install eSpeak or eSpeak-NG ====
+a) Install classic eSpeak:
+<code bash>
+sudo apt update
+sudo apt install espeak
+</code>
+b) Or install the newer eSpeak-NG:
+<code bash>
+sudo apt update
+sudo apt install espeak-ng
+</code>
+Check installation with:
+<code bash>
+which espeak
+which espeak-ng
+</code>
+==== Optional: Install LAME for MP3 output ====
+<code bash>
+sudo apt install lame
+</code>
+Verify:
+<code bash>
+which lame
+</code>
+==== Check PHP Configuration ====
+Make sure the following functions are NOT disabled in ''php.ini'':
+<code ini>
+disable_functions =
+</code>
+These must NOT appear in disable_functions:
+  * ''exec''
+  * ''shell_exec''
+  * ''passthru''
+  * ''system''
+  * ''proc_open''
+If they are listed, remove them and restart the web server.
+==== Check open_basedir Restrictions ====
+If ''open_basedir'' is set in ''php.ini'' or virtual host config, ensure it includes the directories for ''espeak'' and ''lame'':
+<code ini>
+open_basedir = /var/www:/usr/bin:/usr/local/bin:/tmp
+</code>
+You can check active values with:
+<code php>
+<?php
+echo ini_get("open_basedir");
+?>
+</code>
 === Changelog: ===
 == 2025-06-06 (V1.2.2) by Fraenkiman ==