-
-
Notifications
You must be signed in to change notification settings - Fork 163
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Ilia Rostovtsev
committed
Dec 8, 2016
0 parents
commit 8083ea5
Showing
1,392 changed files
with
59,120 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| Before posting an issue, please search through README.md and closed/opened issues to make sure that the answer to your questions hasn't been answered/discussed already. | ||
|
|
||
| Please make sure that you have latest theme (18.31) and Webmin (1.820) versions installed. | ||
|
|
||
| Provide the following information: | ||
| * What is your server-side OS and its version? | ||
| * What is your client-side OS, browser and its versions? | ||
| * What are the steps to reproduce the issue |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| The MIT License (MIT) | ||
|
|
||
| Copyright (c) 2016 Ilia Rostovtsev | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| of this software and associated documentation files (the "Software"), to deal | ||
| in the Software without restriction, including without limitation the rights | ||
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| copies of the Software, and to permit persons to whom the Software is | ||
| furnished to do so, subject to the following conditions: | ||
|
|
||
| The above copyright notice and this permission notice shall be included in all | ||
| copies or substantial portions of the Software. | ||
|
|
||
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,179 @@ | ||
| ##Contents | ||
| * [Changelog](https://github.com/qooob/authentic-theme/blob/master/CHANGELOG.md) | ||
| * [Download (18.31)](https://github.com/qooob/authentic-theme/releases/download/18.31/authentic-theme-18.31.wbt.gz) | ||
| * [About](#about) | ||
| * [FAQ](#faq) | ||
| * [Troubleshoot](#troubleshoot) | ||
| * [Development](#development) | ||
| * [Donation](https://github.com/qooob/authentic-theme#license) | ||
| * [License](https://github.com/qooob/authentic-theme/blob/master/LICENSE) | ||
|
|
||
| ##About | ||
| **Authentic** is [Webmin/](https://github.com/webmin/webmin)[Usermin/](https://github.com/webmin/usermin)[Virtualmin/](https://www.virtualmin.com/)[Cloudmin](http://webmin.com/cloudmin.html) theme based on [Bootstrap](https://github.com/twbs/bootstrap) and [Font Awesome](https://github.com/FortAwesome/Font-Awesome) that is made with _love_. It uses [CodeMirror](http://codemirror.net/) to highlight config files and show line numbers, when editing manually, [CKEditor](http://ckeditor.com/) to compose comprehensive HTML based messages and [DataTables](http://www.datatables.net/) 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](http://configserver.com/cp/csf.html). | ||
|
|
||
| [](http://youtu.be/f_oy3qX2GXo) | ||
|  | ||
|
|
||
| ####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 [*](https://github.com/qooob/authentic-theme#how-do-i-execute-shell-command-using-search-filed) | ||
| * 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 | ||
|
|
||
| ####Browser support | ||
|
|
||
| ###### Chrome 24+ | ||
|
|
||
| ###### Firefox 5+ | ||
|
|
||
| ###### Opera 18+ | ||
|
|
||
| ###### Safari 6+ | ||
|
|
||
| ###### Edge 20+ | ||
|
|
||
| ###### IE 10+ | ||
|
|
||
|
|
||
| ###FAQ | ||
| ####How to install _Authentic_ Theme? | ||
|
|
||
| #####Webmin | ||
|
|
||
| To install _Autentic_ Theme from repository, just `clone` it into your wherever _Webmin_ binary folder _(libexec)_ is. After that, you must rename `authentic-theme-master` directory to `authentic-theme` to make the theme work properly. Besides, you could just [download](https://github.com/qooob/authentic-theme/releases/download/18.31/authentic-theme-18.31.wbt.gz) the theme directly and install it using _Webmin_: | ||
|
|
||
| `Webmin->Webmin Configuration->Webmin Themes->Install themes->From uploaded file` | ||
|
|
||
| #####Usermin | ||
| Use the same procedure as described above to install the theme for _Usermin_: | ||
|
|
||
| `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/and _Cloudmin_ modules are installed, it will be automatically detected and supported. | ||
|
|
||
| ####How to update _Authentic_ Theme automatically? | ||
| The theme has inbuilt feature to notify an administrative user to install updates. To enable this feature, turn `Check for Authentic Theme updates` on 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 make user palettes work? | ||
| _Authentic_ Theme utilizes built-in, custom color palettes, that a user can define using theme's extensions. It's possible, by using theme's _CSS_ extensions, to pass user custom selector, such as `user-palette-1`, `user-palette-2`, `user-palette-3`, `user-palette-4`, `user-palette-5`, `user-palette-6`, `user-palette-7`, `user-palette-8`, `user-palette-9` and `user-palette-10` to enable a usage of user palettes. For example, in order to use `user-palette-1`, in the theme's settings, you would need to set the option _Navigation Menu Color_ to the value of `User Palette 1`. After that, provide a custom code to the theme's _CSS_ extension, with [a pre-built template](http://codepen.io/qooob/pen/dYaPvj), corresponding with custom theme's identification. | ||
|
|
||
| ####How do I execute shell command using search filed? | ||
| 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_. | ||
|
|
||
| ###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. | ||
|
|
||
| #####List of keyboard shortcuts | ||
|
|
||
| * `alphanumeric typing` - quick search | ||
| * `up/down, home/end` - cursor position | ||
| * `enter` - descent into selected directory | ||
| * `backspace` - previous folder | ||
| * in case there is only one row filtered, enter on search field will perform trigger | ||
| * `contextmenu/right-click` - context menu | ||
| * `spacebar` or `Alt+right-click` - select current row | ||
| * `right-click on path` or `Ctrl+L` - enter path manually | ||
| * `*` - inverse select | ||
| * `+` - select all | ||
| * `-` - deselect all | ||
| * `F2` - change permissions | ||
| * `F3` - change ownership | ||
| * `F4` - edit where possible | ||
| * `Esc` - close active editor window | ||
| * `Ctrl+Esc` - minimize active editor window | ||
| * `F5/Shift+F5` - compress/decompress | ||
| * `F6` - rename | ||
| * `Shift+F4/F7` - new file/folder | ||
| * `Shift+F7` - search | ||
| * `F8/Del` - delete | ||
| * `F9/F10` - download/upload | ||
| * `Ctrl+S` - calculate selected size | ||
| * `Ctrl+space` - new tab | ||
| * `Ctrl+Shift+space` - close current tab | ||
| * `Ctrl+left/right` - change tabs | ||
| * `Ctrl+1..9` - switch to the tab number | ||
| * `Ctrl+X/C/V` - cut/copy/paste | ||
| * `Ctrl+Enter/Ctrl+Shift+Enter` - save/save and close currently edited file | ||
| * `Theme reload hotkey` - reload current directory | ||
|
|
||
| ####_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 ..)`<br> | ||
| 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<br> | ||
| 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<br> | ||
| 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<br> | ||
| 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_<br> | ||
| 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<br> | ||
| 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<br> | ||
| This could happen to GPU driver misconfiguration on your OS. For more details refer to [#453](https://github.com/qooob/authentic-theme/issues/453) | ||
|
|
||
| ###Development | ||
| ####Lead developer | ||
| * [Ilia Rostovtsev](https://rostovtsev.ru)[](http://stackoverflow.com/users/1455661/ilia-rostovtsev) | ||
|
|
||
|
|
||
| ###Contributions | ||
|
|
||
| ####Translations | ||
| * [Richard van Laak](https://github.com/Rvanlaak) (Dutch) | ||
| * [Kjetil Elde](https://github.com/w00p) (Norwegian) | ||
| * [Michał Pawlik](https://github.com/majk-p) (Polish) | ||
| * [Michael Keck](https://github.com/mkkeck) (German) | ||
| * [Silviu-Ionut Radu](https://github.com/sealview) (Romanian) | ||
| * [Ilia Rostovtsev](https://github.com/qooob) (Russian) | ||
| * [7stars](https://github.com/7starsone) (Spanish, French, Portuguese) | ||
| * [dreista](https://github.com/Dreista) (Chinese) | ||
| * [jlndk](https://github.com/jlndk) (Danish) | ||
| * [stuchy3](https://github.com/stuchy3) (Czech) | ||
|
|
||
| ###Donation | ||
|
|
||
| Overall development of this theme has already passed the stage of 2000 hours. I'm happy to provide _Authentic_ Theme for free but please know, that it would mean a World to _[me](http://rostovtsev.ru)_, 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. | ||
|
|
||
| [](http://rostovtsev.ru/pub/api/donation/yandex.html) | ||
| <br> | ||
| <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&lc=us&business=programming%40rostovtsev%2eru¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest"></a> | ||
| <br> | ||
| <a href="bitcoin:1AUpmkNSYfKpAUcs5Rz7pPvguRmZU5nPvP"></a> | ||
|
|
||
| ### License | ||
|
|
||
| _Authentic_ Theme is released under the [MIT License](https://github.com/qooob/authentic-theme/blob/master/LICENSE) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| 18.31 |
Oops, something went wrong.