This page is part of our UserSpice Customization Guide.
The usersc folder serves a bunch of purposes that may not be obvious, so we’d like to take a few moments to lay out what it does and does not do.
UserSpice defines addons as Language Packs, Widgets, Plugins and Templates and all but Language Packs are stored in usersc.
Language packs are stored in users/lang
Widgets are in usersc/widgets
Plugins are in usersc/plugins
Templates are in usersc/templates
Although addons are located in the usersc directory, they are not meant to be edited directly. If you want to modify one of the UserSpice addons, the proper way to do that is to copy the addon to another folder. For instance, if you want to modify the standard template, you will copy the
and edit away. This prevents our updates from breaking your modifications. The same holds true for widgets and plugins.
If you don’t like the way something is translated, you can override that in usersc. Let’s say that you want to override Italian (users/lang/it-IT.php). You can create a file called usersc/lang/it-IT.php and override language keys in there. The format looks like this.
<?php $lang = array_merge($lang, array( "DAT_SEARCH" => "Your translation here", "DAT_FIRST" => "Your translation here", ));
This used to be the most common use for usersc, but let’s say that you want to completely override one of the “core” UserSpice php files that is located in the actual /users folder. Something like account.php. You can copy
and your file will load instead of ours. Please note, there is a whole other guide for customizing the dashboard using usersc.
When you’re poking around and considering customizing our files, do a search of the file for the term “usersc”. You will often find that there are optional files that can be created/edited in the usersc folder that will allow you to override/insert something in one of our files without forcing you to maintain a completely separate page.
The usersc/includes folder contains some things that you may want to modify.
The usersc/scripts folder contains some things that you may want to modify.