Skip to content

Webmin/Usermin/Virtualmin/Cloudmin theme based on Bootstrap and Font Awesome

License

Notifications You must be signed in to change notification settings

pgordemer/authentic-theme

 
 

Repository files navigation

#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.

Authentic is fully compatible with latest Webmin 1.730+, Usermin 1.640+, Virtualmin 4.14+ and Cloudmin 8.00+

##Changelog

####Version 9.0.3 (Feb 3, 2015)

  • Fixed file selector filter broken in some cases 📎
  • Fixed a general bug (not theme related), when clicking on external links 📎
  • Fixed ConfigServer Security & Firewall Firefox bug when buttons didn't work 📎

####Version 9.0.2 (Feb 2, 2015)

  • Fixed loader positioning
  • Fixed small buttons under the menu showing correct language link on toggling between Webmin/Virtualmin/Cloudmin
  • Fixed menu jumps 📎
  • Fixed selects incorrectly triggering loader in some cases 📎
  • Improved mobile menu trigger button position and some other mobile menu tweaks

####Version 9.0.1 (Feb 1, 2015)

  • Fixed Firefox bug making right frame links not clickable 📎
  • Improved navigation menu auto-opening

##Changelog ####Version 9.0.0 (Feb 1, 2015)

  • Changed: Overall UI redesign for better experience
  • Changed: Code core complete rewrite for both server and client-side. Improved speed and browser/plugin compatibility
  • Added support for Virtualmin/Cloudmin missing left menu, for currently selected virtual server/machine. Attention: You need latest Virtualmin installation to make it work. (For Virtualmin Pro, minimum version requirement is 4.13 and for GPL users minimum is 4.14)
  • Added autocomplete for currently opened module in Webmin, currently selected domain and list of all available virtual domains/machines in Virtualmin/Cloudmin modules
  • Added complete mobile support. Navigation menu now has absolutely same functionality for both desktop/mobile versions
  • Added custom logo support. Manual for using it is below
  • Added screen-saver effect (using pure CSS) after 2 minutes of inactivity
  • Added shortcut Alt+R for reloading right frame
  • Added Chinese translation by Dreista

Complete Changelog

##Video Screencast

ScreenShot

##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

Features

  • Autocomplete that lets you very quickly and effectively navigate through:
    • Items in left menu
    • Items in 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 switching to Webmin
    • Alt+V switching to Virtualmin
    • Alt+C switching to Cloudmin
  • Extended support for ConfigServer Security & Firewall, with integrated search and filter features
  • Code highlight with line numbers, when editing configuration files manually
  • Custom logo
  • Basic screen-saver effect (pure CSS) after 2 minutes of inactivity
  • Unprecedentedly convenient and complete navigation, with no difference among desktop/mobile versions

Tricks

  • To prematurely dismiss a loader click on it 2 times

##Browser support

##### Chrome 24+

##### Firefox 5+

##### Opera 18+

##### Safari 6+

##### IE 10+

##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 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 logo?

Custom logo can be easily set by coping a file named logo.png to Authentic Theme configuration folder. It's located to wherever Webmin sets it's configuration directory. For example on most systems this path would resolve to /etc/webmin/authentic-theme. Make sure that the file is called logo.png. Recommended size is 180x90 pixels. In case you want to remove the logo, just delete this file. 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.

###Troubleshoot

  1. Can't locate LWP/Simple.pm in @INC (@INC contains: /usr/libexec/webmin..) BEGIN failed--compilation aborted at ..:
    It happens because the theme is trying to load Perl module dependency, that are not installed on your system. LWP::Simple - is the simplest and most common type of HTTP request. You can install it using CPAN module in Webmin itself or using CLI and package manager. For example, in RHEL distro you would be able to install it by running
    yum install perl-libwww-perl.
  2. Can't locate Net/SSLeay.pm in @INC (@INC contains: ..)
    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 is perl-Net-SSLeay.
  3. Can't locate object method "parse" via package "version" (perhaps you forgot to load "version"?) at. Installing version from CPAN, using CPAN module in Webmin will fix this error.
  4. Can't locate Switch.pm in @INC (@INC contains:) You can install Switch module using CPAN in Webmin or by package name perl-Switch to fix this error. In case you got stuck with this error after updating theme and have no access to CLI, no worries, just type in URL http://yourhostname:10000/cpan and from there choose to install Switch module.

##Development ###Lead developer

##Contributions

###Translations

##Donation

Overall development of this theme has already passed the stage of 200 hours. While I am glad to provide Authentic Theme for free, it would mean a world to me, if you could send me a donation. It doesn't matter how big or small your donation is. I appreciate all donations. Each donation will excite future development and improve your everyday experience, while working with the theme.

PayPal or Yandex Money: 41001414241949

License

Authentic Theme is released under the [MIT License][opensource]. [opensource]: http://www.opensource.org/licenses/MIT

About

Webmin/Usermin/Virtualmin/Cloudmin theme based on Bootstrap and Font Awesome

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Perl 95.7%
  • CSS 4.3%