Spaceship Registrar Module for WHMCS

basanta sapkota

Managing domains can be a hassle for hosting providers and resellers, especially when dealing with domain registration, transfers, and renewals. The Spaceship Registrar Module for WHMCS is a powerful tool designed to simplify this process by integrating the Spaceship API directly into WHMCS. In this blog post, we'll dive into the features, installation process, and configuration steps to get you started with this module.

🚀 Overview of the Spaceship Registrar Module

The Spaceship Registrar Module allows seamless management of domains from within the WHMCS platform. It includes key features such as domain registration, transfer, and renewal. The module is designed with hosting providers in mind, making it easier to manage multiple domains through an intuitive interface.

Explore the Project

Check out the full source code and contribute to the project on GitHub:

View on GitHub

⚠️ Disclaimer

Please note that this module is a test project created for educational and personal use. It is not officially endorsed by the Spaceship company. The module may contain bugs or security vulnerabilities, so use it at your own risk. No guarantees or support are provided for this module, so ensure thorough testing before deploying it in a live environment.

🌟 Key Features

  • Domain Registration: Register new domains directly from your WHMCS installation.
  • Domain Transfer: Effortlessly transfer domains between registrars.
  • Domain Renewal: Automate domain renewal to ensure uninterrupted service.
  • Customizable Templates: Adjust domain and error templates to match your branding.
  • Error Handling: Built-in error logging to help you troubleshoot easily.

🔧 Installation Instructions

Setting up the Spaceship Registrar Module is simple. Just follow these steps:

  1. Extract and Upload:

    • Extract the module files and upload the spaceship folder to the modules/registrars/ directory of your WHMCS installation.
  2. Activate the Module:

    • Log into your WHMCS Admin Panel.
    • Go to Setup > Products/Services > Domain Registrars.
    • Activate the "Spaceship" module.
  3. Configure API Credentials:

    • Open the config.json file in the module directory.
    • Enter your Spaceship API key and secret.

⚙️ Configuration Steps

  1. API Setup:

    • In the config.json file, add your Spaceship API key and secret to authenticate your requests.
  2. Language Customization:

    • Modify language strings in lang/english.php to customize the module’s text according to your preferred language or branding.
  3. Template Customization:

    • Update templates/domain.tpl and templates/error.tpl to tailor the domain-related UI and error handling pages.

🧰 File Structure

Here’s a quick overview of the module's file structure:

spaceship/
├── lang/
│   └── english.php       # Language strings
├── lib/
│   ├── SpaceshipAPI.php  # API handler
│   ├── Utils.php         # Utility functions
├── logs/
│   └── api.log           # API request logs
├── templates/
│   ├── domain.tpl        # Domain task template
│   └── error.tpl         # Error page template
├── config.json           # API credentials
├── logo.png              # Module logo
├── spaceship.php         # Main module script
└── README.md             # Documentation

📝 Development Insights

  • Main Module Script: The spaceship.php file serves as the heart of the module, orchestrating the interactions between WHMCS and the Spaceship API.
  • API Handling: The lib/SpaceshipAPI.php file manages all API requests and responses.
  • Utility Functions: Reusable helper functions are housed in lib/Utils.php, streamlining module functionality.

🛠️ Requirements

  • WHMCS Version: 8.x or higher.
  • PHP Version: 7.4 or higher.
  • Valid Spaceship API credentials.

🐞 Troubleshooting

If you run into any issues, here are a few troubleshooting tips:

  • API Errors: Check the logs/api.log file for detailed error messages. Make sure your API credentials in config.json are accurate.
  • Template Issues: Ensure that the syntax in domain.tpl or error.tpl is correct. Clear your WHMCS template cache if changes aren’t visible.
  • Language Support: For additional language support, create a new file in the lang/ directory and update your module settings.

🤝 Contributing

This module is open for contributions! If you’d like to enhance its features or fix bugs, feel free to fork the repository, make your changes, and submit a pull request.

📝 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.

📞 Contact

For any inquiries or support requests, you can reach out via:

By implementing the Spaceship Registrar Module in your WHMCS installation, you can streamline domain management and improve your hosting or reseller operations. Happy domain managing!

Post a Comment