Advanced Profit & Margin Tracker

Profit Calculator CodeUpp Plugin

# Profit Calculator Plugin by CodeUpp

This plugin adds an advanced Profit Calculator for Botble CMS, proudly built by CodeUpp (www.codeupp.xyz).

**Version:** 1.1.0

**Author:** Maryam International LLC by CodeUpp

## Overview

The Profit Calculator plugin provides a comprehensive dynamic interface for calculating precise profit margins per product. It factors in core parameters like base cost price, VAT/Tax/Duty percentages, miscellaneous operational expenses, delivery charges, and payment gateway transaction fees.

## 🚀 Why Buy This Plugin?

-**Total Visibility & Control:** Stop guessing your margins! Maintain an accurate, centralized record of every product's cost price, taxes, payment gateway fees, and miscellaneous expenses.

-**Dynamic Real-Time Calculations:** See instantly whether your current sale price is profitable or generating a loss, calculated directly on your screen.

-**Data-Driven Discounts:** Have a customer asking for a discount? Quickly reference this calculator to know your exact profit margin. You can confidently offer a discount that guarantees customer retention *without* risking a financial loss.

-**Color-Coded Clarity:** Instant visual feedback. Profitable margins shine in bold green, while losses are highlighted in bold red, so nothing slips through the cracks.

-**Seamless Auto-Saving:** Type your numbers and you're done. The plugin uses AJAX to save your data automatically without ever needing to refresh the page.

## 🛠️ How to Install

1. Upload the `profitcalculatorcodeupp` folder into your website's `platform/plugins/` directory.

2. Log in to your Botble Admin Panel.

3. Navigate to **Plugins** in the sidebar menu.

4. Find **Profit Calculator** in the list and click **Activate**.

5. Refresh your admin page, and you will see the new **Profit Calculator** menu item in your sidebar!

## 🔄 Changelog

### v1.1.0 (2 September 2026)

-**Added:** Full Multi-Language Support. The plugin now seamlessly supports and automatically adapts to **Portuguese (PT)**, **Arabic (AR)**, and **English (EN)** based on active theme/admin configurations.

-**Enhanced:** Deep Database Optimization. Implemented advanced Eloquent eager loading and index querying to reduce database strain on large product catalogs.

-**Fixed:** Critical security patches addressing edge-case vulnerabilities in input validation and XSS prevention within the admin tables.

-**Improved:** General UI/UX refinements. Cleaned up table responsiveness, styling, and improved the layout for smaller admin dashboards to ensure a buttery-smooth experience.

-**Refactored:** Core localization logic and controller response payloads for lightning-fast save operations.

### Version 1.0.0

- Initial release.

- Added dynamic real-time profit calculation engine.

- Implemented dedicated database tables for lightning-fast loading.

- Added automatic color-coded profit/loss indicators.

- Added seamless background auto-saving (AJAX).

## 📞 Support & Contact

If you encounter any issues, need further customization, or have feature requests, please reach out!

-**Developer**: CodeUpp

-**Website**: [www.codeupp.xyz](https://www.codeupp.xyz)

-**WhatsApp**: +971553682656

-**Email**: maryaminternationalllc@gmail.com