Difference between revisions of "Admin Area"

From WHMCS Documentation

(Search)
Line 1: Line 1:
==Login==
+
==Logging In==
  
To login to the admin area, simply append the word "admin" to the URL at which you installed WHMCS.  For example if you installed WHMCS @ http://demo.whmcs.com/ then you would access the admin area by typing in http://demo.whmcs.com/admin
+
To login to the WHMCS admin area, navigate to the admin directory within your installation.
  
If you have followed the recommended further security steps (http://wiki.whmcs.com/Further_Security_Steps) then you may have renamed the admin folder to make it harder for visitors to find and therefore the folder name you need to type in might be different.
+
For example if you installed WHMCS @ https://billing.example.com/ then you would access the admin area by visiting https://billing.example.com/admin/
  
An IP Ban is enforced if you make 3 invalid password login attempts to the admin area. By default the ban time is 15 minutes but this can be increased in '''General Settings > Security'''.  If you get banned, you will need to wait for the ban to expire or lift it via the database, please refer to our [[FAQs]].
+
If you have followed the [[Further Security Steps]] and renamed your admin directory, you will need to use the custom name you have setup.
  
==Password Resets==
+
===IP Banning===
  
Admin password resets can be requested from the link on the admin page login form by following the link "Forgot your password?"  There it's simply a case of entering your admin email address to be sent a new password.
+
If multiple failed login attempts are detected from the same IP, an IP ban will be enforced.
  
If you fail to receive the email, or have disabled the forgot your password option, instructions for resetting the admin password can be found in our [[FAQs]].
+
If you get banned, you can wait either wait for the ban to expire or manually remove the ban via the database.  By default the ban lasts for 15 minutes. You can adjust the length of time the ban is enforced for in '''General Settings > Security'''.  For more information on manually removing a banned IP, please refer to our [[FAQs]].
 +
 
 +
===Password Resets===
 +
 
 +
If a password is lost or forgotten, you can request a password reset from the login page.
 +
 
 +
Upon requesting a password reset, you will receive an email containing a link that will allow you to set a new password.
 +
 
 +
If you fail to receive the email, or have disabled the forgotten password option, instructions for resetting the admin password can be found in our [[FAQs]].
  
 
==Templates==
 
==Templates==
  
The admin area comes with 2 templates:
+
The admin area comes with 2 templates as standard:
 +
 
 +
*'''Blend''' - The current default template featuring a responsive design and compatible with laptops, tablets and mobile devices.
 +
*'''V4''' - A web 2.0 styled interface that was the default until Version 5.0.
 +
 
 +
You can customise and create your own custom admin area templates. Please refer to [[Admin Area Template Files]] for more information.
 +
 
 +
===Choosing your admin template===
  
*'''V4''' - A web 2.0 styled interface introduced in Version 4.0
+
Each administrator user has their own preference that controls the admin area theme/template they see and use.
*'''Blend''' - The default template, designed for use on a range of devices including tablets. Introduced in Version 4.5.
 
  
The existing templates can be customised and/or new ones created - see [[Admin Area Template Files]] for more info on that.
+
To see and customise the template that you use for your own admin user, simply navigate to '''My Account''' using the top navigation bar.
  
The template you see when logging in can be set on a per admin level and therefore your staff can choose their preference or you can create different templates tailored to their specific role.  The template for an admin can be set in '''Setup > Administrators'''
+
To see and change the template used by other administrator users, if you have permission, navigate to '''Setup > Staff Management > Administrator Users'''
  
 
==Search==
 
==Search==
  
The admin area has 2 main methods of search - '''Intelligent Search''' & '''Advanced Search'''.  Both of these search options are available from any page.
+
There are 2 primary methods of search - '''Intelligent Search''' & '''Advanced Search'''.  Both of these search options are available from any page.
  
'''Intelligent Search''' is located at the top right of each template and allows you to enter a search term, press enter and the results are instantly displayed. It will search across various fields in the Clients, Products, Invoices & Tickets databases to display the five most relevant matches to the term entered.  However it doesn't search all fields and with large databases because of the amount of data it has to look through can be slower.
+
* '''Intelligent Search''' is located at the top right of every page. To use it, enter a search term and hit enter. Results are dynamically fetched and displayed instantly. Intelligent search makes a best guess attempt at what you are searching for and will display the most relevant matches it is able to find.
  
'''Advanced Search''' allows you to search more specifically, choosing exactly the field you want to search on. It is available from the top menu bar in the Original template, bottom left sidebar in V4 and bottom right sidebar in Simple. Entering a search term here and submitting will take you to the exact match or list of possible matches.
+
'''Advanced Search''' is located in the bottom left of the sidebar on every page. With advanced search, you can choose exactly what entity type and field you wish to perform a search for. Entering a search term here and submitting will take you to the exact match or list of possible matches.
  
 
==Widgets==
 
==Widgets==
The admin summary page is made up of a number of individual 'widgets'. These can be arranged and maximised/minimized by each individual member of staff and enabled/disabled entirely for different administrator roles. To move a widget, simply click and drag the title bar where the widget name is displayed to the desired location and then release it. Before you let go of the mouse, a dotted outline will appear where the widget will be moved to allowing you to confirm it's as you want.
+
The admin homepage dashboard is made up of a number of individual 'widgets'. These widgets can be arranged and maximised/minimized by each individual member of staff and enabled/disabled entirely for different administrator roles.
  
 
Further Reading:
 
Further Reading:
Line 39: Line 53:
 
*[[Creating_a_Widget]]
 
*[[Creating_a_Widget]]
  
==Multi-Language==
+
==Languages==
  
WHMCS supports multiple languages for the admin area making the system truly multi-lingual throughout. Admins can then have a default language set for their profile in the '''Setup > Administrators''' or the '''My Account''' area when logged in.
+
The WHMCS admin area has full multi-language support.
  
The language files for the admin area can be found in the ''/admin/lang/'' folder, from there you can create entirely new additional language translations by translating and saving one of the existing language files with a new name.
+
Each administrator user can set their own language preference via the '''My Account''' page accessed from the top navigation bar.
  
The language files use PHP syntax for storing the variables, so you need to take care when editing the file not to remove the quotes or semi-colons from the ends of lines, and also if wanting to use quotes inside a word or phrase translation, you must escape it with a back slash, eg. "This needs to be \"escaped\"."
+
Language files for the admin area can be found in the '''/admin/lang/''' directory.
  
When it comes to modifying an existing translation an overrides system has been implemented, this has the benefit of when it comes to upgrades you don't have any risk of overwriting and losing your customisations.
+
If you wish to customise the translations for a given language, an overrides file should be created. You can learn more about overrides and how to use them in our [https://developers.whmcs.com/languages/overrides/ Developer Documentation].
The steps for creating an admin area language override are the [[Language_Files#Overriding_Language Strings|same as the client area]] but uploaded to '''/admin/lang/overrides/''' instead.
 
  
We rely on the dedication and generosity of our users for contributing translations, as we find real life translations are a much higher quality compared with using automated translation systems as some softwares do. So if you have any suggestions for improvements, or a new language file you are willing to contribute, please get in touch.
+
<div class="docs-alert-warning">We rely on the contributions of our users for language translations. If you notice any discrepancies or phrasings that you feel could be imported, we welcome you to submit your suggestions for change to our support team. We thank you for your help to ensure our users have the best experience possible, whatever their language.</div>

Revision as of 14:56, 21 December 2017

Logging In

To login to the WHMCS admin area, navigate to the admin directory within your installation.

For example if you installed WHMCS @ https://billing.example.com/ then you would access the admin area by visiting https://billing.example.com/admin/

If you have followed the Further Security Steps and renamed your admin directory, you will need to use the custom name you have setup.

IP Banning

If multiple failed login attempts are detected from the same IP, an IP ban will be enforced.

If you get banned, you can wait either wait for the ban to expire or manually remove the ban via the database. By default the ban lasts for 15 minutes. You can adjust the length of time the ban is enforced for in General Settings > Security. For more information on manually removing a banned IP, please refer to our FAQs.

Password Resets

If a password is lost or forgotten, you can request a password reset from the login page.

Upon requesting a password reset, you will receive an email containing a link that will allow you to set a new password.

If you fail to receive the email, or have disabled the forgotten password option, instructions for resetting the admin password can be found in our FAQs.

Templates

The admin area comes with 2 templates as standard:

  • Blend - The current default template featuring a responsive design and compatible with laptops, tablets and mobile devices.
  • V4 - A web 2.0 styled interface that was the default until Version 5.0.

You can customise and create your own custom admin area templates. Please refer to Admin Area Template Files for more information.

Choosing your admin template

Each administrator user has their own preference that controls the admin area theme/template they see and use.

To see and customise the template that you use for your own admin user, simply navigate to My Account using the top navigation bar.

To see and change the template used by other administrator users, if you have permission, navigate to Setup > Staff Management > Administrator Users

Search

There are 2 primary methods of search - Intelligent Search & Advanced Search. Both of these search options are available from any page.

  • Intelligent Search is located at the top right of every page. To use it, enter a search term and hit enter. Results are dynamically fetched and displayed instantly. Intelligent search makes a best guess attempt at what you are searching for and will display the most relevant matches it is able to find.

Advanced Search is located in the bottom left of the sidebar on every page. With advanced search, you can choose exactly what entity type and field you wish to perform a search for. Entering a search term here and submitting will take you to the exact match or list of possible matches.

Widgets

The admin homepage dashboard is made up of a number of individual 'widgets'. These widgets can be arranged and maximised/minimized by each individual member of staff and enabled/disabled entirely for different administrator roles.

Further Reading:

Languages

The WHMCS admin area has full multi-language support.

Each administrator user can set their own language preference via the My Account page accessed from the top navigation bar.

Language files for the admin area can be found in the /admin/lang/ directory.

If you wish to customise the translations for a given language, an overrides file should be created. You can learn more about overrides and how to use them in our Developer Documentation.

We rely on the contributions of our users for language translations. If you notice any discrepancies or phrasings that you feel could be imported, we welcome you to submit your suggestions for change to our support team. We thank you for your help to ensure our users have the best experience possible, whatever their language.