Improve initial OPAC information

Author: rogercgui

docs/abcd-modules/opac-abcd/opac-admin/general.md

@@ -6,22 +6,62 @@ sidebar_position: 2
 
 # System Architecture & Global Configuration
 
-The ABCD OPAC is not just a search interface; it is a file-based CMS controlled by a hierarchy of configuration files. Understanding this architecture is crucial for troubleshooting and advanced customization.
+The ABCD OPAC is controlled by a hierarchy of configuration files. While advanced users can edit these files directly, the system provides a robust **Graphic Interface (GUI)** to manage global parameters, visual identity, and system cache.
 
-## 1. The Bootloader: `config_opac.php`
-Located in the root of the OPAC (or linked from Central), this PHP file is the first to run. It dictates the environment variables.
+## 1. Global Parameters (GUI)
+**Access:** **General** > **Parameters** (`parametros.php`)
 
-**Key Variables:**
+This interface is the primary way to configure the behavior and look of your portal. It saves changes directly to the `opac.def` file without requiring manual text editing.
+
+![Parameters](../../../media/abcd-modules/opac-abcd/opac-admin/editor-opac-def.png)
+
+### Visual Identity
+* **Logo:** You can upload an image file (PNG, JPG) directly through the interface to replace the site logo.
+* **Favicon (ShortIcon):** Upload the small icon displayed in the browser tab.
+* **Styles (CSS):** Select the color scheme (e.g., `styles.css`, `dark.css`) from the dropdown menu.
+* **Link Logo:** Define the URL where users are redirected when clicking the logo (usually the library homepage).
+
+### Content & Text
+* **Page Title:** The text displayed in the browser's title bar (e.g., "Central Library Catalog").
+* **Footer Text:** A short text line for copyright or contact info appearing at the bottom of every page.
+
+### Security & Technical
+* **CAPTCHA:** Enable Google reCAPTCHA integration to protect forms against bots.
+* **Charset:** Select the character encoding (UTF-8 or ISO-8859-1).
+    * *Note:* This must match your database encoding to avoid character display errors (like `ã`).
+
+---
+
+## 2. Cache Management
+**Access:** **Global Parameters** > **Cache Management** (Bottom of the page)
+
+To improve performance, the OPAC caches search results, facet calculations, and configuration arrays in the `opac/cache/` directory.
+
+### When to Clear Cache?
+You should click the **"Clean Cache"** button if:
+1.  You made changes to `opac.def` or `bases.dat` that are not appearing.
+2.  You updated a PFT format, but records still show the old layout.
+3.  The OPAC seems "stuck" on old search results.
+
+![Clear Cache](../../../media/abcd-modules/opac-abcd/opac-admin/opac-clear-cache.png)
+
+* **Action:** The system deletes temporary files (`*.cache` and temp text files) ensuring that the next user request generates fresh data.
+
+---
+
+## 3. The Backend: `config_opac.php` & `opac.def`
+Although the GUI handles most daily tasks, understanding the underlying files is crucial for troubleshooting and advanced architecture.
+
+### The Bootloader: `config_opac.php`
+Located in the root of the OPAC, this script initializes the environment.
 * **`$db_path`**: The absolute path to the `bases` folder.
-    * *Logic:* Unlike the Central module, the OPAC allows dynamic path switching via the [Multi-Context System](./advanced-access).
-* **`$opac_path`**: The web root of the OPAC.
-* **`$lang`**: The priority logic for language detection (Session > Get > Browser > Default).
-* **`$restricted_opac`**: Defines if the portal is public (`N`) or requires login (`Y`) to even view the home page.
+* **`$lang`**: The priority logic for language detection.
+* **`$restricted_opac`**: Defines if the portal requires login (`Y`) to view the home page.
 
-## 2. Global Settings: `opac.def`
-Located in `bases/opac_conf/opac.def`, this INI file controls the global behavior and appearance.
+### The Configuration File: `opac.def`
+The GUI described above writes to this INI file located in `bases/opac_conf/opac.def`.
 
-### Critical Parameters
+**Example Content:**
 ```ini
 [OPAC]
 OpacHttp=http://localhost:9090/opac/
@@ -30,18 +70,21 @@ link_logo=[http://my-library.org](http://my-library.org)
 TituloPagina=My Library Catalog
 footer_text=© 2024 Library Systems
 styles=styles.css
+captcha=Y
 
 ```
 
-* **`OpacHttp`**: Must match your server's URL exactly. If images break, check this first.
-* **`styles`**: Points to the CSS file in `assets/css/`.
-* **`charset`**: Usually `UTF-8` or `ISO-8859-1`. If special characters appear as `ã`, check this setting.
+:::warning URL Configuration
+The parameter **`OpacHttp`** is critical. It must match your server's public URL exactly. If images break or AJAX searches fail, check this value in the file manually.
+:::
+
+---
 
-## 3. The `opac_conf` Directory Structure
+## 4. The `opac_conf` Directory Structure
 
-The `bases/opac_conf/` folder contains the "Global Configuration" that applies to all databases unless overridden.
+The `bases/opac_conf/` folder contains the "Global Configuration" assets that apply to all databases.
 
 * **`bases.dat`**: The master list of databases available in the OPAC.
 * **`lang.tab`**: Maps language codes (en, es, pt) to human-readable names.
 * **`formatos.dat`**: Defines the output options (ISO, Word, Print) available in the toolbar.
-* **`record_toolbar.tab`**: Controls which icons appear above records (Print, Reserve, etc.).
+* **`record_toolbar.tab`**: Controls which icons appear above records (Print, Reserve, etc.).

docs/abcd-modules/opac-abcd/opac-admin/index.md

@@ -13,17 +13,17 @@ The OPAC is highly customizable. Almost every aspect—from the logo to the sear
 
 **Access:**
 1.  Log in to the **Central Module** as a Superuser.
-2.  Go to **OPAC Configuration** (usually an icon in the main toolbar or a menu option).
 
-<img width="1357" height="693" alt="image" src="https://github.com/user-attachments/assets/f30944ad-0325-40f3-b42f-ae908cf8f59b" />
+![Central Module](../../../media/abcd-modules/opac-abcd/opac-admin/opac-admin-001.png)
+
+2.  Go to **OPAC Configuration** (usually an icon in the main toolbar or a menu option).
 
-<img width="1140" height="424" alt="image" src="https://github.com/user-attachments/assets/c7d77431-1132-4887-9309-eded6498930b" />
+![OPAC Configuration](../../../media/abcd-modules/opac-abcd/opac-admin/opac-admin-002.png)
 
 
 3.  This opens the **OPAC Back-Office** (`conf_opac_menu.php`).
 
-<img width="1363" height="765" alt="image" src="https://github.com/user-attachments/assets/79421aee-4aa4-4afe-9f62-63590042f3a6" />
-
+![OPAC Back-Office](../../../media/abcd-modules/opac-abcd/opac-admin/opac-admin-panel.png)
 
 ## Key Configuration Areas