Difference between revisions of "CustomizingWithLocalDir"
m (2 revisions imported)
|(One intermediate revision by the same user not shown)|
Latest revision as of 16:03, 6 April 2016
Under the RT installation tree, there is a directory called 'local'. You can place files under this directory to override most files in the RT installation without touching the original. Also, this allows you to quickly retrace what has been customized when you upgrade RT. This method works for both Mason components which RT puts under share/html/ and Perl library files which RT puts in lib/.
Suppose you don't like default RT header. The Mason component for this is share/html/Elements/Header. To customize it, simply copy it to local/html/Elements/Header and apply your changes to that file. When you restart your web server, your new Header component will be loaded. You must restart your webserver and clear the Mason object cache (or have DevelMode enabled) to for the changes to take effect.
Important thing to know
You must remember that if you put a
local/lib/Xxx.pm file under the local directory then RT will never try to load
lib/Xxx.pm from the analogous base directory. Files under the local/ directory completely "replace" files from base directories logically.
This can be changed for Mason components. If you want to modify a component, but only use it sometimes and not others, see BypassLocalComponent.
Overriding translation files
Also note that I18N overrides work differently; they go in
local/po instead of
Alternatives to the local dir
In many cases you can instead use CustomizingWithCallbacks to customize the web GUI.
For customizing Perl libraries you should also look at CustomizingWithOverlays. Overlays can be put under the local/lib/ tree.
CustomizingWithPatches may be preferred in some cases.