Giter Club home page Giter Club logo

apiscp-whmcs's Introduction

ApisCP Provisioning Module for WHMCS

By Troy Siedsma (Lithium Hosting)

Requirements:

WHMCS v7.1+ ApisCP must be on version 3.2.5

Configuring

  • Create Plans in ApisCP
  • Install server module in WHMCS
  • Create a server or multiple ApisCP servers under products -> servers
    • Define the hostname, password(api key), check the box for secure and make sure the port is 2083
  • Create a new Product in WHMCS, use apnscp as the module
  • Under module config, select your plan and add / update values as needed (blank is ok to use plan defaults)
  • Create a new hosting account
  • Profit!

Template Changes

  • New in 1.0.8

Edit clientareaproductdetails and add the following after the last {if} before the first

{if $apisVars['is_banned']}
    <div class="alert alert-danger">
        <h3>IP Ban Notice</h3>
        We found your IP Address in the Blacklist in the Panel. <br>Your IP was detected in the following Jails:
        <ul>
            {foreach from=$apisVars['jails'] item=jail}
                <li>{$jail}</li>
            {/foreach}
        </ul>
        We've removed the ban on your IP but any additional suspicious activity may result in banning your IP Again.
        {if $apisVars['rampart_enabled']}
            <br>
            You should also be sure to add your IP {$apisVars['ip']} to the Whitelist
            <a href="clientarea.php?action=productdetails&amp;id={$serviceid}&amp;dosinglesignon=1&amp;app=whitelist" target="_blank" title="Panel Whitelist" class="alert-link">here</a>.
        {/if}
    </div>
{/if}

Supported Features

  • Creating
  • Suspending
  • Unsuspending
  • Terminating
  • Changing Password
  • Changing Plans
  • SSO from WHMCS for Client and Admin
  • SSO with custom links to different apps
  • Automatically unban a user's IP
  • Cancellation Hold
  • Statistics update
  • SiteID Population on stats update

Cancellation Hold

This feature allows you to defer termination of cancelled and terminated accounts for 30 days.
To enable, uncomment lines 242 and 243 in apnscp.php and comment out lines 245 and 246

Comment:

        $opts['force'] = 'true';
        $client->admin_delete_site($site_domain, $opts);

By commenting out that section, you are preventing account deletion.

Uncomment:

        $opts['reason'] = 'Customer Requested Cancellation';
        $client->admin_deactivate_site($site_domain, $opts);

By uncommenting that section, you are forcing account suspension. This means the site will effectively be suspended until the automated process purges the account from the server.
To enable that feature, uncomment the last action hook block in hooks.php

Summary

The ApisCP provisioning module for WHMCS allows you to integrate your billing system with your server management panel so new user accounts will be automatically provisioned, suspended and terminated as needed. Users can change their password as well as use the Single Sign-On (SSO) feature to seamlessly transition from WHMCS to ApisCP.

License

This product is licensed under the GPL v3 (see LICENSE file). Basically, you can't call it your own or sell it. This is meant to be free for the benefit of the community. Help us by improving with Pull Requests!

Contributing

Submit a PR and have fun!
I am a developer by hobby, not profession so don't judge me and I won't judge you :P

Need Help?

Join us in the ApisCP Discord in the #whmcs channel!

apiscp-whmcs's People

Contributors

tsiedsma avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

apiscp-whmcs's Issues

Fuegito

// tests.mjs
import assert from 'node:assert';
import test from 'node:test';

test('that 1 is equal 1', () => {
assert.strictEqual(1, 1);
});

test('that throws as 1 is not equal 2', () => {
// throws an exception because 1 != 2
assert.strictEqual(1, 2);
});

// run with node tests.mjs

[Feature Request] Add Dashboard Login

It would be nice in the Actions sidebar if there was a button called "Login to panel", that would just SSO login right to the dashboard. For those that may want to just browse the panel from the top.

Display issues with New Twenty-One Theme

First, want to say thanks for making this plugin public. It helps a ton!

I know WHMCS 8.1 JUST released, but wanted to post this anyways in case y'all hadn't seen it. Compared to the six theme, which works fine, the client area display is extremely messed up on the Twenty-One theme. Colors, borders, and gradients are all missing, and the quick icons are a mess. I zoomed out in the below screenshots to show the full page. Let me know if I can help in any way! Thank you!

21
212

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.