#Authentic Authentic is Webmin/Usermin/Virtualmin/Cloudmin theme based on Bootstrap and Font Awesome that is made with love. It uses CodeMirror to highlight config files and show line numbers, when editing manually, TinyMCE to compose comprehensive HTML based messages and DataTables to add advanced interaction controls to modules' tables. Theme runs using latest releases of dependent software (mentioned above), supporting all in-built modules (even ancient ones) and third-party modules, including ConfigServer Security & Firewall.
##Changelog
####Version 11.10 (Mar 13, 2015)
Medium Release. New features, improvements and bug fixes. Read more..
##Video Screencast
##Principles
- Make the theme fully support all Webmin/Usermin modules
- Be as beautiful, fast, light and easy to use as possible
- Be compatible with all platforms and support mobile devices
- Security mail notifications for unauthenticated users landing on login page and upon user successful login
- Window automatic scrolling, upon page is populated from server-side
- Autocomplete that lets you very quickly and effectively navigate through items in left menu, items of currently opened module in Webmin, items for currently selected domain and list of all available virtual domains/machines in Virtualmin/Cloudmin module
- Hotkeys for quicker access/control.
Alt+S
for focusing on search field;Alt+R
for refreshing currently opened module;Alt+W/Alt+V/Alt+C/Alt+U/Alt+M
switching to Webmin/Virtualmin/Cloudmin/Usermin/Webmail and doubleShift
(or doubleMouse Click
) to prematurely dismiss right page loader - Extended support for ConfigServer Security & Firewall, with integrated search and filter features
- Code highlight with line numbers, when editing configuration files manually
- Ability to embed custom logos, styles and scripts
- Unprecedentedly convenient and complete navigation, with no difference among desktop/mobile versions
- Dismissable page loader
- Webmin 1.730+ (required), Usermin 1.640+ (optional), Virtualmin 4.14+ (optional), Cloudmin 8.01+ (optional)
##Recommended modules
- Installed Net::SSLeay module, to make automatic update notifications work
##Browser support
##FAQ ###How do I install Authentic theme?
####Webmin
To install Autentic theme from repository, just clone
it into your wherever Webmin binaries folder (libexec) is or download it directly and install it going from Webmin:
Webmin->Webmin Configuration->Webmin Themes->Install themes->From uploaded file
####Usermin a) I'd recommend to create a symlink to already installed Authentic theme, which will enable you to only update Webmin installation of the theme not both.
Creating a symlink as easy as it gets by running as root the following:
ln -s /usr/libexec/webmin/authentic-theme /usr/libexec/usermin/authentic-theme
The above implies that Webmin binaries on your system are installed under
/usr/libexec/webmin/
and Usermin installation is in/usr/libexec/usermin/
. The above is true for CentOS and other RHEL distros at least. You could easily though find out where your installations are by running/usr/bin/whereis webmin
or/usr/bin/whereis usermin
.
b) Nevertheless, you could simply install Usermin theme using the same procedure as for Webmin. To install a copy for Usermin go to:
`Webmin->Usermin Configuration->Usermin Themes->Install themes->From uploaded file`
####Virtualmin/Cloudmin There is no need to take any additional actions. In case Virtualmin or Cloudmin modules are installed, it will be automatically detected and supported.
###How do I set custom logos?
Custom logos can be easily set for both authenticated users and for login screen. It can be done by coping a file named
logo.png/logo_welcome.png
to Authentic Theme configuration folder. It's located to wherever Webmin/Usermin sets it's configuration directory. For example, on most systems this path would resolve to/etc/webmin/authentic-theme
for Webmin and/etc/usermin/authentic-theme
for Usermin. Make sure that the file containing logo is calledlogo.png
for authenticated users andlogo_welcome.png
for login screen. You can access logos with custom CSS styles (read below) by its class name, which is correspondingly_logo/_logo_welcome
. Recommended size is 180x90 pixels. In case you want to remove the logo, just delete this file from configuration directory. In case you want to have Authentic Theme logo, you can find it in theme installation folder (usually located at/usr/libexec/webmin/authentic-theme
), under images directory, with the file name called__logo.png
. Don't forget to rename it, to make it work, when uploading to configuration directory.
###How do I load custom styles?
Custom styles are set by the same procedure described for the logos above. Only the file name that has to be copied to
/etc/webmin/authentic-theme
must bestyles.css
. For example, if you want to changefont-family
for the theme, you would have to add the following to customstyles.css
:
body,
html,
.tooltip,
.popover {
font-family: "Times New Roman", Times, serif;
}
###How do I load custom scripts?
It's done the same way as described for styles and logos above. The file name that has to be copied to
/etc/webmin/authentic-theme
must bescripts.js
. For example, if you want to load custom script and output something to browser's console, you would have to add the following toscripts.js
:
console.log('Script loaded...');
Be advised, you might be surprised to see that your script is executed twice. It's because we technically have two
documents
, first ismain
container and second isright
side that is loaded in iframe. You must refer to the exactdocument
to make your script executed right.
###How do I use theme settings?
Theme can be tweaked using inbuilt settings. The list of the settings will be growing, depending on users' requests. At the moment, Authentic Theme supports the following list of settings:
// Enable/disable loader/spinner for the left frame
settings_loader_left = true;
// Enable/disable loader/spinner for the right frame
settings_loader_right = true;
// Replace dots in mailbox delimiter to slashes (UI only)
settings_mailbox_slash_delimiter = true;
// Autoscroll window down, upon page is populated from server-side
settings_window_autoscroll = true;
// Make all accordions expanded on System Information page
settings_sysinfo_expand_all_accordions = true;
// Check for theme updates on System Information page
settings_sysinfo_theme_updates = true;
// Check for CSF updates on System Information page
settings_sysinfo_csf_updates = true;
// Show/hide Webmin->Refresh Modules link on the left menu
settings_leftmenu_section_hide_refresh_modules = false;
// Show/hide Webmin->Unused Modules link on the left menu
settings_leftmenu_section_hide_unused_modules = false;
// Show/hide left menu's language button/link
settings_leftmenu_button_language = false;
// Show/hide left menu's refresh button/link
settings_leftmenu_button_refresh = true;
// Show Virtualmin->Install Scripts link on the left menu
settings_leftmenu_vm_installscripts = true;
// Show Virtualmin->Edit Web Pages link on the left menu
settings_leftmenu_vm_webpages = true;
// Show Virtualmin->Backup and Restore->Amazon S3 Buckets link on the left menu
settings_leftmenu_vm_backup_amazon = true;
// Show left menu's single links' icons in Virtualmin/Cloudmin
settings_leftmenu_singlelink_icons = true;
// Security notifications
// Format: 'Message|Subject|Comma separated list of users/emails|Comma separated list of trusted/ignored IPs'
// Usage: '%3 login page is accessed by unauthenticated user from %2|%3 login page access alert|root,user@example.org|1.2.3.4,FE00:0000:0000:0000:0000:AAAA:0000:0000'
// Output: From: root, To: Root, Subject: Webmin successful login alert, Message: Webmin successful login alert for user root from 2.3.4.5
// Notify when unauthenticated user is seeing pre-login banner
settings_security_notify_on_pre_login_request = '%3 pre-login page is accessed by unauthenticated user from %2|%3 login page access alert|root';
// Notify when unauthenticated user is landed on login page
settings_security_notify_on_login_request = '%3 login page is accessed by unauthenticated user from %2|%3 login page access alert|root';
// Notify on successful authentication
settings_security_notify_on_login_success = '%3 successful login alert for user %1 from %2|%3 successful login alert|root';
Settings must be initialized by the same procedure described for the scripts above. The only difference is that the file name, that has to be copied to /etc/webmin/authentic-theme
or /etc/usermin/authentic-theme
must be settings.js
. Afterwards, put directives from the list of settings above and control it using boolean data type (true/false)
or other (see comments for each setting respectively).
###Troubleshoot
- Automatic updates notification feature doesn't work or
Can't locate Net/SSLeay.pm in ..)
This happens because Webmin is trying to open a link and download the theme using https protocol.Net::SSLeay
- is high level functions for accessing web servers (by using HTTP/HTTPS). You can install it using CPAN module in Webmin or using CLI. Package name isperl-Net-SSLeay
.- Strange
Â
character is appeared in text-editor mode
This happens because of encoding disparity. To fix this, just set language in Webmin toUTF-8
and make sure that your browser also has detected it asUTF-8
.
##Development ###Lead developer
##Contributions
###Translations
- Richard van Laak (Dutch)
- Kjetil Elde (Norwegian)
- Michał Pawlik (Polish)
- Michael Keck (German)
- 7stars (Spanish, French, Portuguese)
- Dreista (Chinese)
##Donation
Overall development of this theme has already passed the stage of 400 hours. I'm happy to provide Authentic Theme for free but please know, that it would mean a World to me, if you send me a donation. It doesn't matter how big or small your donation is. I appreciate all donations. Each donation will help me to pay my bills, excite future development and improve your everyday experience, while working with the theme.
PayPal or Yandex Money: 41001414241949
Authentic Theme is released under the [MIT License][opensource]. [opensource]: http://www.opensource.org/licenses/MIT