|
|
(902 intermediate revisions by 6 users not shown) |
Line 1: |
Line 1: |
− | <meta name="keywords" content="ip manager for whmcs, ip manager configuration, whmcs ip manager management, whmcs ip manager installation, whmcs ip manager common problems, about whmcs ip manager, whmcs ip manager documentation, whmcs ip manager faq, whmcs ip manager help, whmcs ip manager guide, whmcs ip manager wiki, whmcs ip manager tutorial, whmcs ip manager tips, whmcs ip manager wiki"></meta> | + | <meta name="keywords" content="hosting quota notifications for whmcs, hosting quota notifications configuration, whmcs hosting quota notifications management, whmcs hosting quota notifications installation, whmcs hosting quota notifications common problems, about whmcs hosting quota notifications, whmcs hosting quota notifications documentation, whmcs hosting quota notifications faq, whmcs hosting quota notifications help, whmcs hosting quota notifications guide, whmcs hosting quota notifications wiki, whmcs hosting quota notifications tutorial, whmcs hosting quota notifications tips, whmcs hosting quota notifications wiki"></meta> |
− | <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The IP Manager For WHMCS Module."></meta> | + | <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Hosting Quota Notifications For WHMCS Module."></meta> |
| | | |
− | =About [http://www.modulesgarden.com/products/whmcs/ip_manager/features IP Manager For WHMCS]= | + | =About [https://www.modulesgarden.com/products/whmcs/hosting-quota-notifications Hosting Quota Notifications For WHMCS]= |
| {| | | {| |
− | |style="padding: 10px 0px 5px 0px;"|'''IP Manager For WHMCS''' allows you to conveniently add and manage IP pools, and automatically assign IP addresses to your servers, products, addons or configurable options.<br /> | + | |style="padding: 10px 0px 10px 0px;"|'''Hosting Quota Notifications For WHMCS''' allows you to send automatic notifications to your clients whenever they exceed previously set bandwidth or disk usage. |
− | With our module you will be also able to assign an IP pool to a specified client, integrate with 3rd party applications like cPanel, export IP pools or view clear graphs.<br />
| + | Notifications can be sent in two ways: upon exceeding given resource tier or after exceeding given resource limit in a specified time period.<br /> |
− | You will also be able to synchronize IP addresses used by products in your WHMCS system with the module's IP blocks and pools.<br /> | + | You can also define email templates and view details of each sent notification owing to logs. |
− | What is more, IP Manager For WHMCS will allow your customers to easily manage their IP addresses from the WHMCS client area.
| + | |
| |} | | |} |
| <!--a comment maybe? --> | | <!--a comment maybe? --> |
| *'''Admin Area Features:''' | | *'''Admin Area Features:''' |
| {| | | {| |
− | |style="padding: 10px 0px 0px 30px;"|✔ Create Multiple Configurations For Multiple Scenarios Of IP Addresses Assignment | + | |style="padding: 10px 0px 0px 30px;"|✔ Automatically Notify Your Clients Upon Exceeding Defined Limits Of Bandwidth And Disk Usage |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Create Multiple Relations In One Configuration For Products, Addons, Configurable Options & Servers | + | |style="padding: 0px 0px 0px 30px;"|✔ Configure Notification Groups |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Add IP Pools: | + | |style="padding: 0px 0px 0px 30px;"|✔ Choose Between Two Types Of Group Counting: |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 45px;"|✔ CIDR Notation | + | |style="padding: 0px 0px 0px 45px;"|✔ Tiered - Define Tiers Of Usage |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 45px;"|✔ IP Addresses Range (IPv4 Only) | + | |style="padding: 0px 0px 0px 45px;"|✔ Fixed - Define Usage Grow Over Time |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 45px;"|✔ IP Addresses List (IPv4 Only) | + | |style="padding: 0px 0px 0px 30px;"|✔ Assign Multiple Products To Single Notification Group |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Add IPv6 Block In CIDR Notation | + | |style="padding: 0px 0px 0px 30px;"|✔ Assign Email Templates Per Notification Group |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Export IP Pools To XML And CSV Format | + | |style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Notification Groups |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Import IP Pools From XML And CSV Files
| + | |style="padding: 0px 0px 10px 30px;"|✔ View Logs Of Sent Notifications |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Synchronize IP Addresses Used By Products In WHMCS With IP Manager
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Exclude Selected IP Addresses From IP Pool During Its Creation
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Integrate With 3rd Party Applications:
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ cPanel
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ [http://www.modulesgarden.com/products/whmcs/cpanel_extended/features cPanel Extended]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ Plesk
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ Parallels Cloud Server
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ [http://www.modulesgarden.com/products/whmcs/solusvm_extended_vps/features SolusVM Extended VPS]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 45px;"|✔ [http://www.modulesgarden.com/products/whmcs/proxmox_vps/features Proxmox VPS]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Create New Integration Modules
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Assign/Unassign IP Addresses From IP Pool For Specified Client Service
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Omit Dedicated IP Address Fields For Specific Configuration
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Define Custom Field Usage
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Receive Automatic Email Reminder Sent When Specified Usage Percentage Of Any IP Pool Has Been Exceeded
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Define Configuration Of Integration Method (cPanel & cPanel Extended)
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Set Up IP Addresses Cleaner - Ensures That All Assigned IP Addresses Are In Use
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ View IP Pool Usage Statistics And Graphs
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 30px;"|✔ View Logs | + | |
− | |}
| + | |
− | *'''IP Pool Features:'''
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 0px 30px;"|✔ Lock IP Pool To Client
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Filter Data In IP Addresses List
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ View IP Addresses Of IP Pool
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Delete Single IP Address From Pool
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Bulk Actions - Assign/Unassign/Delete IP Addresses
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Create Custom Fields For IP Pool Or IP Address
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 30px;"|✔ Generate Free IP Addresses
| + | |
− | |}
| + | |
− | *'''IP Block Features:'''
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 0px 30px;"|✔ View IP Pools Of Block
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ View IP Addresses Of IP Pool
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Assign/Unassign/Delete Any IP Pool
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Create Custom Fields For IP Pools
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 30px;"|✔ Generate Free IP Pools
| + | |
− | |}
| + | |
− | *'''Client Area Features:'''
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 0px 30px;"|✔ View Assigned IP Addresses
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Unassign IP Addresses
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 30px;"|✔ Order Additional IP Addresses
| + | |
| |} | | |} |
| *'''General Info:''' | | *'''General Info:''' |
| {| | | {| |
− | |style="padding: 10px 0px 0px 30px;"|✔ Supports IPv4 and IPv6 | + | |style="padding: 10px 0px 0px 30px;"|✔ Multi-Language Support |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Supported All Types Of Configurable Options
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ IPv6 Pools Relying On IP Addresses Range And Assigned IP Addresses (Free IPv6 Addresses Are Not Stored In Database)
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Block Assignment Of IP Addresses For IPv6
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support
| + | |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Templates Five and Six | + | |style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.6 Up To PHP 7.2 |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V5 and V6 | + | |style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V7 |
| |} | | |} |
| | | |
| =Installation= | | =Installation= |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|'''This tutorial will show you how to successfully install and configure IP Manager For WHMCS.''' <br /> | + | |style="padding: 10px 0px 30px 15px;"|'''This tutorial will show you how to successfully install and configure Hosting Quota Notifications For WHMCS.''' <br /> |
| We will guide you step by step through the whole installation and configuration process. | | We will guide you step by step through the whole installation and configuration process. |
| |} | | |} |
| + | ==Installation== |
| {| | | {| |
− | |style="padding: 0px 0px 20px 15px;"|'''1. Log in to your client area and download IP Manager For WHMCS.''' | + | |style="padding: 10px 0px 20px 15px;"|'''1. Log in to our client area and download the module.''' |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM1.png]] | + | |style="padding: 0px 0px 20px 25px;"|[[File:HQN_1.png]] |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 15px 15px;"|'''2. Upload and extract the module into the main WHMCS directory.'''<br /> | + | |style="padding: 0px 0px 10px 15px;"|'''2. In the downloaded file you will find two packages that support different PHP versions.'''<br/>As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2.<br/>It does not apply to open source versions.<br/> |
− | Files in your WHMCS directory should look like this.
| + | '' '''Note''': You can check the current PHP version in your WHMCS. To do so, proceed to ''' 'Utilities' › 'System' › 'PHP Info'.''' |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM2.png]] | + | |style="padding: 0px 0px 20px 25px;"|[[File:PHP56_72.png]] |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 15px 15px;"|'''3. When you install IP Manager for the first time, you have to rename '' 'license_RENAME.php' '' file.'''<br /> | + | |style="padding: 0px 0px 15px 15px;"|'''3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.'''<br /> |
− | File is located in '' 'modules/addons/ipmanager2/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
| + | The content of PHP version files should look like this. |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM3.png]] | + | |style="padding: 0px 0px 20px 25px;"|[[File:drfere.png]] |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 15px 15px;"|'''4. In order to configure your license key, you have to edit a previously renamed '' 'license.php' '' file.'''<br /> | + | |style="padding: 0px 0px 15px 15px;"|'''4. When you install Hosting Quota Notifications For WHMCS for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br /> |
− | Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area'' → 'My Products'. ''
| + | File is located in '' 'modules/addons/hosting_quota_notifications/license_RENAME.php' '' . Rename it from '' 'license_RENAME.php' '' to '' 'license.php' '' . |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM4.png]] | + | |style="padding: 0px 0px 20px 25px;"|[[File:HQN_3.png]] |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 15px;"|'''5. Remove all files from '' 'tempates_c' '' folder located in your WHMCS root directory.''' | + | |style="padding: 0px 0px 15px 15px;"|'''5. In order to configure your license key, you have to edit a previously renamed '' 'license.php' '' file.'''<br /> |
| + | Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area'' → 'My Products' ''. |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 15px 15px;"|'''6. Now, you have to activate the module in your WHMCS system.'''<br /> | + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_4.png]] |
− | Log in to your WHMCS admin area and go to '' 'Setup' '' → '' 'Addon Modules'. ''<br />
| + | |
− | Afterwards, find '' 'IP Manager' '' and press '' 'Activate' '' button.
| + | |
| |} | | |} |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM5.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|'''7. In the next step you need to permit the access to the module.'''<br />
| |
− | Click on '' 'Configure' '' button, tick desired admin roles and press '' 'Save Changes'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM6.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|'''8. The last step is setting chmod 755 to '' 'storage' '' folder.'''<br />
| |
− | Folder is located in '' 'you_whmcs/modules/addons/ipmanager2'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM6.1.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|'''9. You have just successfully installed IP Manager!'''<br />
| |
− | You can access your module in '' 'Addons' '' → '' 'IP Manager'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM7.png]]
| |
− | |}
| |
− | =Configuration and Management=
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|'''IP Manager For WHMCS allows you to manage dedicated IP addresses' pools, automatically assign them to clients/products/servers/addons/configurable options.<br />
| |
− | IP Manager supports both IPv4 and IPv6. '''<br />
| |
− | Module enables clients to manage and order dedicated IP addresses.<br />
| |
− | In this short guide we will present you the possibilities of our module.
| |
− | |}
| |
− | ==IP Pools==
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|To manage any IP pool via IP Manager you have to add it first.<br />
| |
− | There are four ways to do that. You can use CIDR notation, enter IP addresses range, provide a full list of IP addresses or create IP blocks for subnets.<br /> <br />
| |
− | ''Note 1: IP addresses range and IP addresses list support IPv4 only.''<br />
| |
− | ''Note 2: IPv6 pools rely on IP addresses range. Additionally, only assigned IP addresses are stored in the database.''<br />
| |
− | ''Therefore free IPv6 addresses will not be visible in the IP pool overview.''<br/>
| |
− | ''Note 3: IP Block Assigned For Subnet feature is currently available for IPv6 only.''
| |
− | |}
| |
− | ===Create IP Pool===
| |
− | {|
| |
− | |style="padding: 10px 0px 20px 15px;"|To begin, add a new IP addresses pool, press'' 'Create a New Pool' '' button.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM7_1.png]]
| |
− | |}
| |
− | ====Classless Inter-Domain Routing Notation====
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|The first notation is '' 'Classless Inter-Domain Routing (CIDR)'. ''<br/>
| |
− | Select IP version, type the first IP address from a pool and a netmask (in prefix notation).<br/>
| |
− | Correct ranges:<br/>
| |
− | *IPv4 - 1 to 32
| |
− | *IPv6 - 1 to 128
| |
− | ''Note: The first IP from the pool should be compatible with [http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing CIDR notation].''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM8.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|You can exclude any number of IP addresses from the pool.<br />
| |
− | To do so, enter them into '' 'Excluded IP Addresses:' '' textarea, one IP address or IP range per line.<br />
| |
| | | |
− | '''TEGO NEI MA!! - DOWIEDZIEC SIĘ'''<BR/>
| + | ==Configuration of Addon== |
− | Additionally, you can exclude boundary IP addresses through marking '' 'Exclude Boundary' '' checkbox.<br />
| + | |
− | '''TEGO NEI MA!! - DOWIEDZIEC SIĘ'''<BR/>
| + | |
− | If you want to set nameservers and gateway click on '' 'Toggle Advanced Settings'. ''
| + | |
− | |}
| + | |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM8_1.png]] | + | |style="padding: 10px 0px 15px 15px;"|'''6. Now you have to activate the module in your WHMCS system.'''<br /> |
| + | Log in to your WHMCS admin area. Go to '' 'Setup' '' → '' 'Addon Modules' ''. Afterwards, find '' 'Hosting Quota Notifications' '' and press '' 'Activate' '' button. |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 15px 15px;"|Enter nameservers and gateway address into textboxes as shown on the screen below ''(This step is optional)''.<br /> | + | |style="padding: 0px 0px 20px 25px;"|[[File:HQN_5.png]] |
− | Afterwards, confirm the creation of an IP pool through pressing '' 'Add Pool' '' button.
| + | |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_2.png]] | + | |style="padding: 0px 0px 15px 15px;"|'''7. In the next step you need to permit access to this module.'''<br /> |
| + | To do so click on '' 'Configure' '' button, tick '' 'Access Control' '' near required admin role groups and press '' 'Save Changes' ''. |
| |} | | |} |
− | ====IPv6 Block Assigned For Subnet====
| |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|The other way can be used only for IPv6. Provide a valid network block address, then select the number of subnets that will be created for the block.<br/>
| + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_6.png]] |
− | Finally press ''Add Pool'' button.<br/>
| + | |
− | ''Note 1: This option supports only IPv6 addresses.''
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM801.png]] | + | |
| |} | | |} |
| | | |
− |
| |
− | ====IP Addresses Range====
| |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|Select '' 'IP Range'. ''<br /> | + | |style="padding: 0px 0px 15px 15px;"|'''8. You have just successfully installed Hosting Quota Notifications For WHMCS!'''<br /> |
− | Type the first and the last IP address of a pool you wish to add.
| + | You can access your module in '' 'Addons' '' → '' 'Hosting Quota Notifications' ''. |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM8_3.png]]
| + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_7.png]] |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|You can exclude any number of IP addresses from the pool.<br />
| + | |
− | To do so, enter them into '' 'Excluded IP Addresses:' '' textbox, one IP address or IP range per line.<br />
| + | |
− | Additionally, you can exclude boundary IP addresses through marking '' 'Exclude Boundary' '' checkbox.<br />
| + | |
− | You should also enter netmask which your IP pool fits in.<br />
| + | |
− | If you want to set nameservers and gateway click on '' 'Toggle Advanced Settings'. ''<br />
| + | |
− | Otherwise, press '' 'Add Pool' '' button and your IP pool will be created.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM8_4.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|Fill out nameservers and gateway address as shown on the screen below ''(This step is optional)''.<br />
| + | |
− | Afterwards, confirm creation of an IP pool through pressing '' 'Add Pool' '' button.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_5.png]]
| + | |
− | |}
| + | |
− | ====List of IP Addresses====
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 15px 15px;"|Select '' 'One or more single IP Addresses'. ''<br />
| + | |
− | Type in IP addresses you want to add, comma separated, after typing in the last IP address press '' 'Enter' '' button.<br />
| + | |
− | Afterwards, confirm creation of IP pool through pressing '' 'Add Pool' '' button.<br />
| + | |
− | ''Note 1: This option supports only IPv4 addresses.''<br />
| + | |
− | ''Note 2: For each IP address added this way, one IP pool will be created.''
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_8.png]] | + | |
| |} | | |} |
| | | |
− | | + | =Configuration and Management= |
− | | + | |
− | ===Show IP Pools===
| + | |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|To manage previously created pools and blocks, proceed to '' 'IP Pool' '' → '' 'Show IP Pools'. ''<br /> | + | |style="padding: 10px 0px 30px 15px;"|'''In this section we will show you how to properly set up and use Hosting Quota Notifications For WHMCS.''' |
− | As you can see on the following screen, you can find here a list of IP Pools and a list of IP Blocks.
| + | |
| |} | | |} |
| + | ==Configuration== |
| {| | | {| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_6_1.png]] | + | |style="padding: 10px 0px 15px 15px;"|In '' 'Configuration' '' page you can find the list of configured notification groups.<br /> |
| + | You can enable/disable any of them, as well as alter or completely remove them.<br /> |
| + | Press '' 'Create New Group' '' to proceed. |
| |} | | |} |
− | ====Additional Information====
| |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|You can edit IP pools additional information even after creation of the pool.<br /> | + | |style="padding: 0px 0px 20px 25px;"|[[File:HQN_9.png]] |
− | To do so, press the option you want to alter.
| + | |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM8_6.png]] | + | |style="padding: 0px 0px 15px 15px;"|Now, you can define all products related to this configuration and email template which will be used to notify your clients.<br /> |
| + | You can choose between two types of resource usage counting:<br /> |
| + | *Fixed - define amount of resources over specific time period. If client usage growth has exceeded the given limit in specified time, a notification will be sent. |
| + | *Tiered - defines amount of resources. If client exceeds given limit, a notification will be sent. |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 20px 15px;"|Afterwards, enter a new value and press save button as shown on the screen below. | + | |style="padding: 0px 0px 20px 25px;"|[[File:HQN_10.png]] |
| |} | | |} |
| {| | | {| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_7.png]] | + | |style="padding: 0px 0px 15px 15px;"|For example, shown below module uses fixed counting type.<br /> |
| + | As you can see, we have defined limits for both bandwidth and disk.<br /> |
| + | Settings shown below result in sending notification to client upon: |
| + | *bandwidth usage growth by 5GB during 21 days. |
| + | *disk usage growth by 100GB over period of 14 days. |
| |} | | |} |
− | ====Custom Fields====
| |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|IP Manager allows you to add custom fields per IP pool.<br /> | + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_11.png]] |
− | To add a new custom field, press '' 'Create a New Custom Field'. ''<br />
| + | |
− | Afterwards, fill out the form with custom field name and value.
| + | |
| |} | | |} |
| + | ==Logs== |
| {| | | {| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM8_9.png]] | + | |style="padding: 10px 0px 15px 15px;"|Under '' 'Logs' '' page you can view information about sent notifications. |
| |} | | |} |
− | ====Assign To A Client====
| |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|If you wish to assign an IP pool to a client, our module makes it available to you.<br /> | + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_12.png]] |
− | You can achieve that through using auto-complete textbox to choose the client and pressing '' 'Save Changes' '' button.<br />
| + | |
− | ''Note: IP addresses will be added to all products ordered by client.''
| + | |
| |} | | |} |
| + | ==Notifications== |
| {| | | {| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM9.png]] | + | |style="padding: 10px 0px 15px 15px;"|You can create as many notifications as you wish.<br /> |
| + | The only requirement is their type being set to '' 'Product/Service' ''.<br /> |
| + | Additionally, you can use {if} statement, as shown below: |
| + | {if $bw_over} Your bandwidth usage is over {$bw_over}MB{if $bw_current} (current: {$bw_current}MB){/if}.{/if} |
| + | {if $disk_over}Your disks usage is over {$disk_over}MB{if $disk_current} (current: {$disk_current}MB){/if}.{/if} |
| + | It will allow you to use this email template for bandwidth and disk notifications at the same time. |
| |} | | |} |
− | ====IP Pool Details====
| |
| {| | | {| |
− | |style="padding: 10px 0px 20px 15px;"|To view IP pool details press on its address as shown on the following screen.
| + | |style="padding: 0px 0px 30px 25px;"|[[File:HQN_13.png]] |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM10.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|In IP pool view you can find information about current assignment of IP addresses in the pool and manually manage their assignment.<br />
| + | |
− | We also added records' filters to facilitate the management of addresses.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM11.png]]
| + | |
− | |}
| + | |
− | '''Bulk Actions'''
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|Our module supports actions on multiple IP addresses.<br />
| + | |
− | To issue such action, mark involved IP addresses and choose desired action from '' 'Action For Selected IP Addresses' '' dropdown menu.<br />
| + | |
− | Afterwards, confirm your choice through pressing '' 'Save Changes'. ''
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM11_1.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|
| + | |
− | *'''Delete From The Pool''' - as its name suggests, removes IP addresses from a pool.
| + | |
− | *'''Unassign''' - removes IP addresses from products they were assigned to, IP addresses still remain in the pool.
| + | |
− | *'''Unassign Using Submodules''' - works in the same way as '''Unassign''' does.
| + | |
− | Additionally, it removes IP addresses from external servers.
| + | |
− | *'''Assign''' - is the most interesting option, it allows you to:
| + | |
− | **Choose a product which IP addresses should be assigned to.
| + | |
− | **Define whether or not to use 3rd party integration module.
| + | |
− | **Set them as assigned without assigning them to any product. You can also add a note to each involved IP address.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM11_2.png]]
| + | |
− | |}
| + | |
− | ====Custom Fields For IP Addresses====
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 15px 15px;"|Additionally, you can assign a custom field to IP address.<br />
| + | |
− | Some 3rd party integration submodules may need additional information provided along with IP address (like MAC address) this it the place to add them.<br />
| + | |
− | To add custom field, press '' 'Add a New Custom Field' '' next to IP address you want to assign a custom field to.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM11_3.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Afterwards, fill in '' 'Custom Field Name' '' and '' 'Custom Field Value' '' and press '' 'Save Changes' ''.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM11_4.png]]
| + | |
− | |}
| + | |
− | ===IP Blocks List===
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 15px 15px;"|You will find here any information on the blocks including:<br/><br />
| + | |
− | '''Pool details'''
| + | |
− | *Maximum available subnets in the block
| + | |
− | *Number of subnets that can be generated
| + | |
− | *Number of already generated subnets
| + | |
− | *Number of generated and ready to be assigned subnets
| + | |
− | *Subnets CIDR
| + | |
− | *Available address in the subnet<br/>
| + | |
− | '''Additional Information'''
| + | |
− | *Nameservers
| + | |
− | *Gateway
| + | |
− | *:Manage the block additional information just like it was described in case of IP pools management<br/>
| + | |
− | '''Usage'''
| + | |
− | *Percentage graph on generated subnets
| + | |
− | *Percentage graph on subnets assignment<br/>
| + | |
− | '''Actions'''
| + | |
− | *Delete button<br/>
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM120.1.png]]
| + | |
− | |}
| + | |
− | ====IP Block Details====
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 20px 15px;"|Press any block to see details and move to the list of the bloc's subnets.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM120.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|If you do not have any subnets yet, you can generate them here.<br/>Press ''Generate Subnet'' button.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM121.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Enter the number of Subnets that will be generated and press '' 'Submit'. ''
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM122.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Now you can see the generated subnets for that block.<br/>
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM123.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|Block subnets management:<br/><br />
| + | |
− | '''IP Block Details'''
| + | |
− | #Block and its usage details
| + | |
− | #Pool details
| + | |
− | #Address range
| + | |
− | #Services assigned
| + | |
− | #Username
| + | |
− | #Client Name
| + | |
− | #Custom Fields
| + | |
− | #*Press ''Create a New Custom Field'' to generate
| + | |
− | #Available actions:
| + | |
− | #*Assign To
| + | |
− | #*Unassign
| + | |
− | #*Delete<br/>
| + | |
− | '''IP Addresses In Pool'''<br/>
| + | |
− | #IP Address in the pool
| + | |
− | #Full IP address
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM124.png]] | + | |
| |} | | |} |
| | | |
− | ==IP Assignment Mechanism== | + | =Tips= |
| {| | | {| |
− | |style="padding: 10px 0px 30px 15px;"|It is crucial to understand mechanism of automatic IP addresses assignment. In this section we will clarify it to you.<br /> | + | |style="padding: 10px 0px 30px 15px;"| |
− | '' 'IP Quantity' '' field defines the quantity of IP addresses added to the ordered product by triggering a specific relation.<br />
| + | |
− | Two and more relations from one configuration can be triggered for the same product (therefore, multiple quantity of IP addresses can be assigned).<br />
| + | |
− | Additionally, if you set up two configurations with the same relation, IP addresses from both configurations will be added.<br />
| + | |
− | Therefore, if you set up these two configurations in IP Manager:
| + | |
− | *'''Configuration 1''': Addon A (IP Quantity = 2), Product C (IP Quantity = 1)
| + | |
− | *'''Configuration 2''': Addon A (IP Quantity = 2), Addon B (IP Quantity = 2), Product D (IP Quantity = 3)
| + | |
− | Orders listed below will trigger different relations:
| + | |
− | *'''Order 1''': Product C with addon A: 5 IP addresses assigned
| + | |
− | *'''Order 2''': Product C with addon B: 3 IP addresses assigned
| + | |
− | *'''Order 3''': Product D with addon A: 7 IP addresses assigned
| + | |
− | *'''Order 4''': Product F with addon A: 4 IP addresses assigned
| + | |
− | |}
| + | |
− | ==Automatic IP Assignment==
| + | |
− | {|
| + | |
− | |style="padding: 10px 0px 15px 15px;"|The main reason, why this module has been created, was to automate IP addresses assignment.<br />
| + | |
− | Here we will show you how to set up its configuration. In order to start, go to '' 'Configuration' '' → '' 'Create Configuration'. ''<br />
| + | |
− | Type your configuration name, press textboxes corresponding to options you wish to add and select them from dropdown menus.<br />
| + | |
− | Afterwards, press '' 'Create New Configuration' '' button. On the screen below you can see sample configuration with two products.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM12.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Now you have to assign at least one IP pool to configuration. You can do it through '' 'Assigned Pools' '' or '' 'Assigned Blocs' '' button.<br/>
| + | |
− | '''''Note: It is possible to assign IPs using either pools or blocks! You are not allowed to assign both to one configuration.'''''<br/>
| + | |
− | Let's start with Assigning pools.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM13.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|Next, choose an IP pool from a dropdown menu and press '' 'Add Pool' '' button.<br />
| + | |
− | Keep in mind that you can assign multiple pools to a single configuration.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM14.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 15px 15px;"|If you wish you can assign IP using blocks assignment. You can also assign blocks to the configuration. <br/>
| + | |
− | To do so, press ''Assigned Blocks'' in the configuration.<br/>
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM127.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Select block from the list of available and press ''Assign A Block'' button.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM125.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 15px;"|Added block will appear on the list of below.<br/>
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM126.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 15px;"|Keep in mind that you can add more than one block to a single configuration.
| + | |
| |} | | |} |
| | | |
− | ==Advanced Configuration== | + | =Update Instructions= |
| {| | | {| |
− | |style="padding: 10px 0px 15px 15px;"|Let's say, that you want to set multiple IP assignment to specific product, it is available with our module!<br /> | + | |style="padding: 10px 0px 30px 15px;"|Essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/><br/> |
− | Here we will show you how to set up multiple IP addresses assignment to configurable option '' 'Extra IP Addresses'. ''<br />
| + | Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!<br/> |
− | Create a new configuration as while setting up a standard configuration.<br />
| + | To take advantage of it, simply use the '''License Upgrade''' button located on the product's page and a discounted invoice will be generated automatically.<br/> |
− | Once it is done press '' 'Configurable Options' '' as shown on the screen below.
| + | |
| |} | | |} |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM15.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|Afterwards, mark checkboxes next to configurable options you want to assign IP addresses to.<br />
| |
− | Enter quantity of IP addresses which will be assigned to each configurable option and press '' 'Save Changes'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM16.png]]
| |
− | |}
| |
− |
| |
− | ==Usage Graph==
| |
− | {|
| |
− | |style="padding: 10px 0px 20px 15px;"|In each configuration you can find a graph, which shows the statistics of IP addresses assignment.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM17.png]]
| |
− | |}
| |
− | ==3rd Party Integration==
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|In this tab you can set up 3rd party integration which allows you to manage IP through our module in your WHMCS and synchronize changes on 3rd party servers.<br />
| |
− | ''Note 1: Some of these integration submodules require free IP pools (cPanel) or IP addresses (Plesk) on servers to be set up.''<br />
| |
− | ''Note 2: IP Manager can integrate multiple IP addresses with a single product.''
| |
− | |}
| |
− | ===Enabling 3rd Party Integration===
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"| Activation of all integration modules looks similar, there is only a difference in cPanel and cPanel Extended integration submodules.<br />
| |
− | Start by pressing '' 'Activate' '' button next to a module you want to activate.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM18.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"| Press '' 'Configure' '' button and assign configurations to it.<br />
| |
− | Confirm through clicking '' 'Save Changes' ''.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"| cPanel and cPanel Extended additionally allow you to choose the method of the integration.<br />
| |
− | 1. Creates a DNS zone for each IP address assigned to a product.<br />
| |
− | 2. The first IP address assigned to a product is set up as a site dedicated IP address.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19_1.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"| As you can see on the following screen, you can easily check the quantity of configurations assigned to each 3rd party integration.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM19_2.png]]
| |
− | |}
| |
− | ===Integration With Proxmox VPS/Cloud For WHMCS===
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|Integration with Proxmox VPS For WHMCS & Proxmox Cloud For WHMCS are the only integrations which are set up on both IP Manager For WHMCS and integrated module sides.<br />
| |
− | Due to that, setting up the integration consists of 3 steps:<br />
| |
− | 1. Create IP addresses pool which will be used for product.<br />
| |
− | 2. Create configuration and assign a previously created pool to it. '''No additional action is required in this step.'''<br />
| |
− | <!--3. Go to product → '' 'Module Settings' '' tab and assign a previously created configuration in '' 'IP Manager' '' section.<br /> --><br />
| |
− | '''Important: Assigning anything beyond the IP pool to the configuration in IP Manager For WHMCS may cause unexpected effect in your WHMCS environment.'''
| |
− | |}
| |
− | ===Integration With SolusVM Extended VPS For WHMCS===
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|Integration with SolusVM Extended VPS For WHMCS is tricky.<br />
| |
− | IP Manager For WHMCS cannot inject the first IP address to VPS, due to the way SolusVM API works.<br />
| |
− | After creation of VPS, IP Manager is able to add additional IP addresses.<br />
| |
− | Therefore, if you are using this integration, we advise setting up IP Manager synchronization as a cron job.
| |
− | |}
| |
− | ===Test Integration Module===
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|This module logs information about IP processing for '' 'Autorelease' '' type products.<br />
| |
− | Your order should look similar to the one on the screen below.<br />
| |
− | ''Note: You need to set up '' 'Autorelease' '' type server, otherwise logs will not show up.''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM19.1.png]]
| |
− | |}
| |
− | ===Creation of Integration Submodule===
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|You can create your own integration, all you need is knowledge of PHP programming language.<br />
| |
− | You can do it through using '' 'Autorelease' '' submodule file.<br />
| |
− | 1. To begin, make copy of '' 'AutorelaseIntegration.php' '' located in '' 'your_whmcs/modules/addons/ipmanager2/app/modules'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19.2.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|2. Rename copy to your new submodule name.<br />
| |
− | ''Note: File name has to end with 'Integration', for example 'NewSubmoduleIntegration.php'.''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19.3.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|3. Edit the file, start by entering basic settings.
| |
− | 1. Class name should be the same as the file name.
| |
− | 2. Submodule name visible in IP Manager.
| |
− | 3. Submodule description displayed in IP Manager.
| |
− | 4. Place here an integrating module name ( the best way is to copy a folder name of the module ).
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19.4.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|4. Now, it is time to implement integration part, you will need integrated module documentation to do that.
| |
− | 1. Configuration of 3rd party integration submodule.
| |
− | 2. Code assigning IP address to module product goes here.
| |
− | 3. You can add a code to unassign IP address here.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM19.5.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|4. In order to view a submodule you have just created, log in to your WHMCS and go to '' 'Addons' '' → '' 'IP Manager' '' → '' '3rd Party Integration'. ''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM19.6.png]]
| |
− | |}
| |
− | ==Export==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|You can export your IP pools to CSV and XML files.<br />
| |
− | To export, go to '' 'Export' '' tab, choose IP pool to export and file format.<br />
| |
− | Confirm through pressing '' 'Save Changes' '' button. Download of the file will start shortly.<br />
| |
− | ''Note: Your '' 'storage' '' folder located in 'your_whmcs/modules/addons/ipmanager2' should have chmod set to '''755'''.''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM25.3.png]]
| |
− | |}
| |
− |
| |
− | ==Import==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|In '' 'Import' '' tab you can find tools to synchronize IP addresses from your WHMCS as well as import them from a file.<br />
| |
− | '''Synchronization'''<br />
| |
− | Synchronization will confirm relations in your system with relations in IP Manager pools.
| |
− | *IP address is used by a product, but inside of IP Manager pool is marked as unassigned - record inside of a pool will be updated.
| |
− | *IP address is used by a product, but does not exist in any IP Manager pool - a new pool will be created.
| |
− | There are three available cron commands:<br />
| |
− | 1. This cron command synchronizes all products (it will require confirmation).<br />
| |
− | 2. This cron command synchronizes all products (it will not require any confirmation).<br />
| |
− | 3. This cron command synchronizes only products which IDs have been provided as arguments separated by comma.<br />
| |
− | '''Import'''<br />
| |
− | To import IP addresses from a file, select it, choose its format and press '' 'Import'.''
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM24_1.png]]
| |
− | |}
| |
− | ==IP Logs==
| |
− | {|
| |
− | |style="padding: 10px 0px 20px 15px;"|'' 'Logs' '' page stores the history of actions ordered on each IP address.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM24_5.png]]
| |
− | |}
| |
− | ==Settings==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|'''Along with great power comes great responsibility.'''<br />
| |
− | IP Manager For WHMCS allows you to define its behavior, therefore make sure you configure settings that suit you needs.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM24_2.png]]
| |
− | |}
| |
− | ===Module Settings===
| |
− | {|
| |
− | |style="padding: 10px 0px 20px 15px;"|Below, you can find description of each option.
| |
− | *'''Assignment Process Settings'''
| |
− | *#For any configuration you provide into this field, '' 'Dedicated IP' '' field will be omitted.
| |
− | *#If checked, additional IP addresses will be stored in a custom field or '' 'Assigned IPs' '' field.
| |
− | *#If checked, in case of a server provisioning failure, relation will be saved.
| |
− | *#Automatically process the IP address when downgrading the configurable option.
| |
− | *#Module ignores error message from an external server and continues the action.
| |
− | *'''IP Logs Settings'''
| |
− | *#IP addresses without product or user will not be displayed in '' 'IP Logs' '' page.
| |
− | *'''Email Reminder Settings'''
| |
− | *#If you check this checkbox, you will receive an email with notification about IP pools running out of IP addresses.
| |
− | *#Enables you to define percentage value which, when exceeded by any IP pool, results in a notification being sent.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM24_3.png]]
| |
− | |}
| |
− | ===IP Addresses Cleaner===
| |
− | {|
| |
− | |style="padding: 10px 0px 20px 15px;"|IP Addresses Cleaner allows you to restore/remove IP addresses form WHMCS/IP Manager/both depending on chosen settings.
| |
− | *'''IP Addresses Cleaner Settings'''
| |
− | *#IP address are added to hosting if relation exists.
| |
− | *#IP address' relation are removed if IP address is not assigned to any hosting.
| |
− | *#If IP address does not exist in any IP pool, it is removed from hosting.
| |
− | *#Create IP address' relation if it does not exist.
| |
− | *#If IP address does not exist in any IP pool, it is removed from relations.
| |
− | *#Set IP address as unassigned if its relation does not exist.
| |
− | '''Important:''' After making any changes in those settings, press '' 'Update Settings'. ''<br />
| |
− | Otherwise, settings will not be saved and the Cleaner will run using old ones.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM24_4.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|IP Addresses Cleaner allows you to automatically find and fix broken IP addresses assignment.<br />
| |
− | For example, when you manually remove a product with IP addresses assigned or remove an IP pool.<br />
| |
− | To start IP Addresses Cleaner, press '' 'Perform Cron Cleanup' ''.<br />
| |
− | Actions issued by the cleaner are listed in a popup as shown on the following screen.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM24_6.png]]
| |
− | |}
| |
− | ==Integration Code==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|'''Integration described below is not obligatory.'''<br />
| |
− | Module allows your customers to view IP addresses assigned to their product and order additional ones.<br />
| |
− | To enable it, follow these simple steps:
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_49.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|Correctly placed code is presented on the following screen.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_50.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|In the client area it should look like on the screen below.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_51.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|To allow your customers to buy a new IP address you need to set up a product addon for product and assign the addon to a configuration in IP Manager.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|The above described integration works for all products without exception.<br/> However, in case you wish to restrict the integration to limited number of products, please insert the below codes instead of the one suggested in the addon. <br/><br />
| |
− | <code>
| |
− | {if $moduleclientarea}
| |
− | <div class="moduleoutput">;{$moduleclientarea|replace:'modulebutton':'btn'}
| |
− | {if $pid == 26 || $module == 'proxmoxCloud' || $module == 'proxmoxVPS'}
| |
− | {$ipmanager_integration}
| |
− | {/if}
| |
− | </div>
| |
− | {/if}
| |
− | </code>
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 15px;"|Once such code is inserted in the template, IP Manager will be displayed for product with ID that equals 26 or if the product is based on '' 'proxmoxCloud/proxmoxVPS' '' modules.<br/> Extend the IP Manager integration according to your needs. The above code is just an example which can undergo modifications.
| |
− | |}
| |
− | ==Client Area==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|Your clients can view and manage their IP addresses and IP pools thanks to installed IP Manager For WHMCS module.<br />
| |
− | To remove any IP address or pool from a product, simply press '' 'Unassign' '' button.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_52.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|Your client can also order a new IP address.<br />
| |
− | Press '' 'Order Additional IP Addresses' '' as shown below.<br />
| |
− | Your client will be moved to order form containing previously configured addons.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_53.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 15px;"|As soon as the addon is active, new IP address is granted.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM_54.png]]
| |
− | |}
| |
− |
| |
− | ==Add IP via Addon==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|Setting up an addon allows your client to add an IP address to their product using integration.<br />
| |
− | Go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Product Addons' '' and press '' 'Add New Addon' ''.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_55.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|Afterwards, enter addon name, addon description and select applicable products.<br />
| |
− | Set pricing for addon by choosing '' 'Billing Cycle' '' and typing price.<br />
| |
− | Confirm through pressing '' 'Save Changes' '' button.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_56.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|Now, go to '' 'Addons' '' → '' 'IP Manager' '' and use configuration created before or [http://www.docs.modulesgarden.com/IP_Manager_For_WHMCS#Automatic_IP_Assignment create a new one].<br />
| |
− | Remember to add a previously created addon as a configuration relation.<br />
| |
− | You can do it by pressing '' 'Addon' '' button as shown on the following screen.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_57.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|Tick checkbox next to addon and enter the quantity of IP addresses to be added.<br />
| |
− | Afterwards, click '' 'Save Changes' '' button.
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 20px 25px;"|[[File:IPM_58.png]]
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 15px;"|If you enabled integration for the client area, your client should be able to order new IP addresses.
| |
− | |}
| |
− | ==Management of Custom Hooks==
| |
− | {|
| |
− | |style="padding: 10px 0px 15px 15px;"|Our module allows you to use custom hooks. All you have to do is create some functions using PHP programming language.<br />
| |
− | Here you can see possible hooks:
| |
− | before_ip_assign_hook($ip, $serviceid, $relation, $configid)
| |
− | after_ip_assign_hook($ip, $serviceid, $relation, $configid)
| |
− | before_ip_integrating_hook($ip, $service, $server)
| |
− | after_ip_integrating_hook($ip, $service, $server)
| |
− | before_ip_disintegrating_hook($ip, $service, $server)
| |
− | after_ip_disintegrating_hook($ip, $service, $server)
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 15px 15px;"|To find details about hooks read '' 'custom_hooks.php' '' file.<br />
| |
− | You can find there all hooks, information about their time of run, returned values and parameters.<br />
| |
− | For example, if you want to throw message to activity log after IP address assignment find hook '' 'after_ip_assign_hook($ip, $serviceid, $relation, $configid)' '' and type:
| |
− | Logger::factory()->log('Custom hook was triggered');
| |
− | It should look like on the screen below:
| |
− | |}
| |
− | {|
| |
− | |style="padding: 0px 0px 30px 25px;"|[[File:IPM_59.png]]
| |
− | |}
| |
− | ==How To Update==
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|In order to upgrade your module, follow [[Modules_Update|Modules Update]] article.
| |
− | |}
| |
− | =Tips=
| |
− | {|
| |
− | |style="padding: 10px 0px 30px 15px;"|1. If your client orders a product that is combined with two configurations (e.g. by product type and configurable option), IP Manager will add IP addresses from both configurations.
| |
− | |}
| |
− |
| |
| =Common Problems= | | =Common Problems= |
| {| | | {| |
− | |style="padding: 10px 0px 10px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.''' | + | |style="padding: 10px 0px 30px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.''' |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 15px;"|2. If you see something like this when moving to '' 'Addon' '' → '' 'IP Manager', '' remove content of '' 'template_c' '' folder.
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 10px 25px;"|[[File:IPM_60.png]]
| + | |
− | |}
| + | |
− | {|
| + | |
− | |style="padding: 0px 0px 30px 15px;"|3. If you export file and it is empty, check your '' 'Storage' '' folder chmod, it should be set to '''755'''. Folder is located in '' 'your_whmcs/modules/addons/ipmanager2' ''.<br />
| + | |
− | If you still have that problem, set chmod '''777'''.
| + | |
| |} | | |} |