Skip to content

Latest commit

 

History

History
139 lines (105 loc) · 9.78 KB

README.md

File metadata and controls

139 lines (105 loc) · 9.78 KB
Raw

Contents

About

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, CKEditor 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.

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

  • Configurable theme options using Webmin UI
  • Top-down terminal port
  • Favorites feature for any content page
  • Unprecedentedly convenient and complete navigation menu for both desktop and mobile
  • Notification slider for quick access to pushed system messages
  • Autocomplete for quick and effective navigation with ability to execute shell commands *
  • Hotkeys for quick access control
  • Dynamically updated page title based on current module
  • Code highlight when editing files manually
  • Extensive list of customizable theme options, with ability to embed user logos, styles and scripts
  • Extended support for File Manager and ConfigServer Security & Firewall modules

Requirements

  • Webmin 1.830+ (required), Usermin 1.700+ (optional), Virtualmin 5.00+ (optional), Cloudmin 9.00+ (optional)

Recommended modules

  • Installed Net::SSLeay module, to make automatic update notifications work

Supported browsers

Chrome 58+ (recommended)
Firefox 53+
Opera 45+
Safari 10+
Edge 40+

FAQ

PGP signature verification

After adding theme's public key to your keyring, you can check that the downloaded file that you want to install is original and unmodified, by verifying its signature with running gpg --verify authentic-theme-18.49.wbt.gz-sig.asc authentic-theme-18.49.wbt.gz command in the console.

How to update Authentic Theme manually?

Theme can be easily updated manually. Please make sure that you have git command installed on your system. Using console, do the following:

  1. Go to Webmin (cd /usr/libexec/webmin) or Usermin (cd /usr/libexec/usermin) directory *
  2. Descend into theme's directory (cd authentic-theme)
  3. Run ./theme-update.sh and hit y to continue
    * Binary directory might be different from libexec depending on the system. Run whereis webmin to figure this out.

How to update Authentic Theme automatically?

The theme has inbuilt feature to notify an administrative user to install updates. To enable this feature, turn on Check for Authentic Theme updates in theme settings.

How do I customize the theme?

Theme has configurable options, that are located in Webmin->Webmin Configuration->Webmin Themes. There as well, you can upload custom logos and code custom styles.css, scripts.js and scripts.pm.

How do I execute shell command using search field?

Type ! in search, followed by your command. Example: ! ls -lsaZ /root. It's required to have Command Shell module available.

How do I make the theme load faster?

Webmin has in-built option to compress static files. It's possible to enable this feature by going to Webmin->Webmin Configuration->Web Server Options and setting Gzip compress static files option to Use pre-compressed file and compress dynamically.

Another solution would be to install used by default Roboto Font locally to prevent extra load from embedding it and later setting it in the theme's settings accordingly.

Extended support for bundled/third-party modules

File Manager

Theme has great support for this module, by adding numerous mast-have features. Most noticeable are listing without page reload (using XHR requests) and full keyboard support, which enables you to use File Manager just as normal desktop browser.

ConfigServer Security & Firewall

Theme only re-renders this module and adds support for code highlight, when editing files manually.

Troubleshoot

  1. 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 Perl module in Webmin or using command-line. Package name is perl-Net-SSLeay. Besides, in case you have mentioned module installed and automatic update feature still doesn't work, you would have to also install either LWP::Protocol::https or Bundle::LWP using CPAN or by package name perl-LWP-Protocol-https or perl-libwww-perl respectively;
  2. Strange  character is appeared in text-editor mode or other encoding issues
    This happens because of encoding disparity. To fix this, just set language in Webmin to UTF-8 and make sure that your browser also has detected it as UTF-8. Pay attention, that Webmin in-built module, named Change Language and Theme can override global settings;
  3. I get HEAD 404 (File not found) in console
    That is not really an error. It happens, when theme is checking, if needed URL exists and can be loaded;
  4. Page loading got stuck
    To prematurely dismiss a loader, hover on it and click loader's close button, right next to it. It is also possible to unveil currently loading content page by double clicking on it;
  5. Can't toggle checkbox in a row of a table
    Theme provides an extended support for operations with table rows. It's easy to select current row by simply right-clicking on it with the mouse (on mobile device long-tap). Regular click on the row will take you to the row's main link;
  6. Default tab after logging in doesn't work
    You need to set Authentic Theme as default globally. To do so, go to Webmin->Webmin Configuration->Themes.
  7. Blinking navigation menu or overall jerky theme's rendering
    This could happen to GPU driver misconfiguration on your OS. For more details refer to #453

Development

Lead developer

Contributions

Translations

Donation

You can make a difference. Donations show appreciation. Your donations would help me to pay my bills and excite future development.



License

Authentic Theme is released under the MIT License