# Admin Area



# Product Information

### Hetzner Datacenter module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-hetzner-datacenter.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-HetznerDatacenter/) | [FAQ](https://faq.puqcloud.com/)

The "Product Information" section is a comprehensive dashboard that provides administrators with detailed information and control over a specific product or service associated with a user's account. This interface is critical for managing and troubleshooting the product, as well as for making configuration changes.

#### Key Elements:

1. **Order Information:**
    
    
    - **Order #:** Displays the order number and provides a link to view the full order details.
    - **Product/Service:** Specifies the name of the product or service (e.g., "Hetzner product").
    - **Server:** Indicates the data center or server instance where the product is hosted.
2. **User and Server Details:**
    
    
    - **Hostname:** The hostname assigned to the server.
    - **Dedicated IP:** The public IP address assigned to the server.
    - **Username:** The username associated with the server's access credentials.
    - **Password:** The password field shows the encrypted password or a placeholder for the server’s access credentials.
    - **Status:** The current status of the service (e.g., "Active").
    - **Assigned IPs:** Lists both IPv4 and IPv6 addresses assigned to the server.
    - **Nameserver 1 & 2:** The nameservers associated with the product.
    - **Operating System:** The operating system installed on the server (e.g., "debian-11").
    - **Backup Option:** Indicates whether the backup feature is enabled or disabled (in this case, "Yes").
3. **Billing and Subscription Details:**
    
    
    - **Registration Date:** The date when the product or service was registered.
    - **Quantity:** The quantity of the product or service being managed.
    - **First Payment Amount:** The initial payment made for the service.
    - **Recurring Amount:** The recurring cost associated with the service.
    - **Next Due Date:** The next billing date for the service.
    - **Termination Date:** If applicable, the date when the service is scheduled to be terminated.
    - **Billing Cycle:** Indicates the billing cycle for the service (e.g., "Free").
    - **Payment Method:** The payment method used for the service (e.g., "PayPal").
    - **Promotion Code:** Displays any promotion code applied to the service.
4. **Module Commands:**
    
    
    - **API Connection Status:** Displays the status of the API connection, which is necessary for managing the product through automated scripts or external systems. (e.g., "API answer OK").
    - **Commands:** Provides buttons for creating, suspending, unsuspending, terminating the service, changing the package, and sending a custom welcome email.
5. **Server Status:**
    
    
    - This section provides real-time status information about the server: 
        - **Start/Stop:** Indicates whether the server is running or stopped.
        - **CPU, RAM, and Disk Usage:** Displays the resource usage statistics for the server.
        - **Datacenter:** Indicates the data center location.
        - **Public Network IPs:** Shows the public IPv4 and IPv6 addresses assigned to the server.
        - **Public Network DNS PTR:** Displays the PTR record for reverse DNS.
6. **Metric Statistics:**
    
    
    - This section shows various usage metrics and their statuses, including: 
        - **Floating IPv4/IPv6 addresses:** Whether these are enabled and their current usage.
        - **Bandwidth Usage:** The amount of bandwidth used.
        - **Snapshot Usage:** The amount of disk space used by snapshots.
    - A **Refresh Now** button allows updating the metrics to display the latest data.
7. **Addons and Additional Information:**
    
    
    - **Addons:** Lists any additional services or features associated with the product.
    - **Hostname (Domain):** Displays the domain associated with the product.
    - **Password:** Shows the password or its placeholder.
    - **Subscription ID:** Identifies the subscription tied to the service.
    - **Override Auto-Suspend:** Allows the administrator to prevent the service from being automatically suspended.
    - **Auto-Terminate End of Cycle:** Provides an option to terminate the service at the end of its billing cycle.
    - **Admin Notes:** Allows the administrator to add any notes or information relevant to the management of the service.
8. **Save or Cancel Changes:**
    
    
    - **Save Changes:** A purple button to save any changes made in this section.
    - **Cancel Changes:** Allows the administrator to discard any modifications and revert to the previous settings.

<p class="callout info">**IP Address Logging.** The system now includes a mechanism that automatically tracks and logs all IP address changes. Every time a new IP address is added or an existing one is removed, a note is automatically added to the **Admin Notes** section. This note includes the date, time, and details of the IP changes. This feature ensures that all changes are documented for easy reference and auditing.</p>

[![image-1725264544352.png](https://doc.puq.info/uploads/images/gallery/2024-09/scaled-1680-/image-1725264544352.png)](https://doc.puq.info/uploads/images/gallery/2024-09/image-1725264544352.png)

# Product configuration in WHMCS

### Hetzner Datacenter module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-hetzner-datacenter.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-HetznerDatacenter/) | [FAQ](https://faq.puqcloud.com/)

**License key:** A pre-purchased license key for the "PUQ Hetzner Datacenter" module. For the module to work correctly, the key must be active.

**Server name:** This option allows you to add a prefix string to the server name. A new name will be generated each time the create account function is called. The NameServer will be present only if the field is set: `NameServer-[*user_id*]-[*service_id*]`.

**Server type:** The type of server to be deployed. Selected from the available server types provided by Hetzner. This field is automatically populated based on your selection in *Select Server and Location*.

**Server location:** The physical location of the server. Selected from the available locations provided by Hetzner. This field is automatically populated based on your selection in *Select Server and Location*.

**Server placement groups:** Controls how the server should be grouped within the data center. This field is automatically populated based on your selection in *Select Placement Group*.

**Server image:** The operating system image to be used for the server. Automatically populated based on the selection in *Select Image*.

**SSH keys:** Keys used for accessing the server. Multiple keys can be added. Auto-populated based on the selection in *Select SSH Keys*.

**Server networks:** Networks to which the server will be connected. Auto-populated based on your selection in *Private Networks*.

**Server firewalls:** Firewall rules to be applied to the server. Select from predefined rules or create custom ones. Auto-populated based on the selection in *Select Firewalls*.

**User data:** Custom user data used during server creation (e.g., cloud-init). Field limit: 32KB.

**Package setting:** Additional settings for the package:

- **Hide PTR open record:** Hides the PTR control button in the client area.
- **Not allow access to server on VNC/NC:** Prohibits access to the server console.
- **Not allow access to Charts:** Hides server resource charts.
- **Not allow reset password:** Disables the password reset action for the service.
- **Backup:** Allows access to server backups. Select the name of the custom field (default: *Backup*).
- **Snapshot:** Allows access to server snapshots.
- **Server labels:** Adds labels to the server; `user_id` and `service_id` are added automatically.
- **Hide inputs on client area:** Hides inputs (domain, password, username, nameserver1/2) and sets server label(s) in the client area.
- **Firewall for suspend service:** Select a firewall profile used when suspending the service (or disable the VM).
- **Link to instruction:** A documentation link displayed in the client area.
- **Username as root:** Use `root` as the administrative username (otherwise the image default is used).

#### **Automatic Pricing &amp; Rounding (UI)**

<p class="callout info">The right-hand panel contains a live pricing tool for bulk price management. It keeps UI and backend pricing fully consistent.</p>

- **Base price (Net/Gross):** Displays the Hetzner base price. Choose Net or Gross as a starting point.
- **Percentage margin:** Enter the markup applied to the Hetzner base price.
- **Select currencies:** Bulk-select one or more currencies for which prices will be generated.
- **Select periods:** Bulk-select billing cycles (Monthly, Quarterly, Semi-Annually, Annually, Biennially).
- **Preview table:** Prices recalculate instantly when Base price or Percentage changes.
- **Apply Bulk Pricing:** Updates or creates missing `tblpricing` rows for the selected currencies and periods.
- **Automatically apply price daily:** Enables daily synchronization via cron using the saved configuration.
- **Rounding policy:** Always round *up* according to ISO-4217 minor units (0/2/3 decimals). Monthly price is rounded first, then multiplied by the period factor and rounded again. The JS preview and server-side logic are identical.
- **Currency source:** Uses Hetzner Cloud API `/pricing.currency` (no hard-coded EUR). Server JSON responses follow currency precision.
- **Expanded dropdown descriptions:** Server selectors show *name – architecture – cores – memory – disk* for clarity.

<p class="callout info">Bulk pricing settings are persisted per product in `available_servers_input` (Base64 JSON) and merged safely without overwriting unrelated saved fields.</p>

#### **Daily Cron automation**

- DailyCronJob respects the saved bulk pricing configuration.
- Fetches the latest Hetzner base price once per run and applies it to all selected currencies and periods.
- Creates missing `tblpricing` rows and logs detailed status for each action (with trace identifiers in Module Log).

#### **Admin Tools for Stock Management**

- **Clear and Reset:** Restores `stockcontrol` and `qty` values in product configuration from the saved record.
- **restore\_saved\_stockcontrol (AJAX):** Restores data from storage and removes the old entry. Logged states: *input*, *not\_found*, *updated\_product*, *deleted\_saved*, *done*, *error*.

#### **API Settings**

<p class="callout warning">**Please pay attention to the order of filling in the API Settings section.** Different locations expose different networks; some networks are not available in specific locations.</p>

**Select Server and Location:** Choose the server type and location from the available options provided by Hetzner.

**Select Image:** Choose the operating system image for the server from the available options provided by Hetzner.

<p class="callout info">You can deploy services from your backups or snapshots to pre-configure solutions for clients.</p>

**Custom option name for image:** Specify a custom option name for the server image if needed.

<p class="callout warning">**Custom option name for image** is evaluated only during initial deployment. Pass the image name you want to use for server creation.</p>

**Allow user to select ISO image:** Enable this option to allow users to select an ISO image.

**Allow user to reinstall service:** Enable this option to allow users to reinstall the service from the client area.

**Allow user to choose backup and snapshot when reinstalling service:** Enable this to let users select a backup/snapshot for reinstall.

<p class="callout warning">**When enabled,** users can browse their snapshots and backups and reinstall the system directly from a chosen snapshot or backup.</p>

**Select Placement Group:** Choose the placement group for the server from the available options provided by Hetzner.

**Select SSH Keys:** Choose the SSH keys used to access the server.

**Public Networks:** Configure public networking (enable/disable public IPv4 and IPv6).

<p class="callout warning">If you turn off public networks, you must attach at least one private network.</p>

**Private Networks:** Configure the private networks attached to the server.

**Select Firewalls:** Choose firewall rules to be applied to the server.

#### **Email configuration:**

Use pre-built templates to notify users about common actions:

- **Custom Welcome Email**
- **Custom start stop service Email**
- **Custom reset server password Email**
- **Custom snapshot action Email**
- **Custom backup action Email**
- **Custom ISO action Email**
- **Custom reinstall action service Email**

#### **Metric Billing:**

- **Floating IPv4 addresses:** Configure pricing for floating IPv4 addresses.
- **Floating IPv6 addresses:** Configure pricing for floating IPv6 addresses.
- **Bandwidth Usage (GB):** Configure pricing for bandwidth usage.
- **Snapshot Usage (GB):** Configure pricing for snapshot storage/usage.

[![product_hetzner.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/7sBproduct-hetzner.png)](https://doc.puq.info/uploads/images/gallery/2025-10/7sBproduct-hetzner.png)