Différences

Ci-dessous, les différences entre deux révisions de la page.

--- start:overrides [2026/02/08 19:03] – [A bit of theory] admin
+++ start:overrides [2026/02/08 21:23] (Version actuelle) – [Customcripts] admin
@@ Ligne 13: / Ligne 13: @@
 We propose further some theorical approach of the concern:
-First will we propose a theorical definition of the "Technical Impact" of a design decision. The technical impact roughly determines how amount of effort will be necessary to maintain properly a working application.
+First will we propose a theorical definition of the "Technical Impact" of a design decision. The **technical impact** (Imp) roughly determines how amount of effort will be necessary to maintain properly a working application:
-$Imp = \frac{Nop * Xop * Of}{Aut}$
+<html><center style="font-size:170%">$Imp = \frac{Nop * Xop * Of}{Aut}$</center></html>
+The impact unit should be not far from some Energy measurement.
+It can be modelized roughly as a function of increasing factors: Number of maintenance operations - Nop, complexitxy of operations - Xop, and probably an organisational factor that increases when both number and complexity grows. Organisational factor can include f.e. an increasing of the number of actors in the operations and the loss in coordination.
+Opositely, there is one big factor that helps reducing the technical impact : Automation (Aut). The more automated you are (including also power tools, not necessary fully automated), the less the technical impact will be a trouble.
+Now we can address the notion of "Trouble". "Trouble" is a subjective notion, and wil not affect all actors the same way. Maintainers will have "Trouble" in having to maintain complex things and make it available for users. Users will be troubled in not having friendly enough or unefficiant tools, stakeholders will be troubled to get informed and harassed that thing do NOT WORK well.
@@ Ligne 24: / Ligne 29: @@
 ====Customcripts====
+Customscripts are a "soft" way to get over the moodle core limitations. Customscripting is a standard mechanism to get core code replaced by a customized version, WITHOUT interfering with core code from the official Git or distribution.
+By defining a directory (often ''/customscripts'') at moodle code's root (or outside) and adding a key:
+   $CFG->customscripts = '<moodlepath>/customscripts';
+In your config file, then any request to a php script say: ''https:<nowiki>//</nowiki><mymoodle>/a/b/c.php'' that encounters an existing file named ''/customscripts/a/b/c.php'' will be derouted at end of the ''setup.php'' initialisation to that file, includes the file, then continue normal processing.
+Customscripts MUST NOT include ''config.php'', because it has already be done before routing to customscript.
+By ending the customscript by a ''die()'' or ''exit()'', the customscripted script REPLACES the standard behaviour.
+Customscripts MUST NOT redefine classes, functions or any "compilation time definitions", as the standard version has already be loaded into memory.
+===Good cases===
+Customscripts work fine when the change is very superficial, and resides in the moodle page itself (vs. a deeper library).
+===Less good cases===
+When the change is deeper, customscripting will force you to deroute deeper calls to derouted APIs, so the code path may need a lot of work to reach the changing point.
+Too complicated derouting will lead to replacing a LOT of standard code. As the standard code is occulted in your Moodle, it will not reveal upgrades or bugfixes, so your replaced code will diverge slowly from moodle standard state of the art. this can be problematic.
 ====Core patchs====
+====Tracking patches and customscriptings needs in plugin design====
 [[:start|Back to general index]]