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:
Extract and Upload:
- Extract the module files and upload the
spaceship
folder to themodules/registrars/
directory of your WHMCS installation.
- Extract the module files and upload the
Activate the Module:
- Log into your WHMCS Admin Panel.
- Go to Setup > Products/Services > Domain Registrars.
- Activate the "Spaceship" module.
Configure API Credentials:
- Open the
config.json
file in the module directory. - Enter your Spaceship API
key
andsecret
.
- Open the
⚙️ Configuration Steps
API Setup:
- In the
config.json
file, add your Spaceship API key and secret to authenticate your requests.
- In the
Language Customization:
- Modify language strings in
lang/english.php
to customize the module’s text according to your preferred language or branding.
- Modify language strings in
Template Customization:
- Update
templates/domain.tpl
andtemplates/error.tpl
to tailor the domain-related UI and error handling pages.
- Update
🧰 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 inconfig.json
are accurate. - Template Issues: Ensure that the syntax in
domain.tpl
orerror.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:
- Email: springmusk@gmail.com
- Website: Basanta Sapkota
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!