Download the PHP package jinomdeveloper/helpers without Composer

Jinom Helpers

A Laravel package that provides useful utility functions for Indonesian developers. This package includes tax calculation services and Indonesian Rupiah currency formatting helpers, making it easier to handle financial calculations in Indonesian web applications.

Perfect for e-commerce applications, invoicing systems, or any Laravel project that needs to handle Indonesian tax calculations and currency formatting.

Features

• Tax Calculator: Calculate Indonesian tax (PPN 11%) with support for both inclusive and exclusive tax calculations
• Currency Formatter: Format numbers to Indonesian Rupiah (IDR) currency format
• Number to Words: Convert numbers to Indonesian text (terbilang)
• Currency Parser: Parse Indonesian currency strings back to numbers
• Phone Number Formatter: Format Indonesian phone numbers to E.164 international format
• Easy Integration: Simple Laravel facade and service provider integration
• Clean API: Intuitive and chainable methods for common operations

Installation

You can install the package via composer:

The package will automatically register itself via Laravel's package discovery feature.

Usage

Tax Calculations

The package provides a comprehensive tax calculation service that handles Indonesian PPN (11% tax rate).

Tax Inclusive Calculations (Price includes tax)

When you have a price that already includes tax and want to break it down:

Tax Exclusive Calculations (Price excludes tax)

When you have a base price and want to add tax:

Currency Formatting

Format numbers to Indonesian Rupiah currency format:

Number to Words (Terbilang)

Convert numbers to Indonesian words:

Currency String to Number

Parse Indonesian currency strings back to numbers:

Phone Number Formatting

Format Indonesian phone numbers to E.164 international format:

Using Without Facade

You can also use the classes directly:

Practical Examples

E-commerce Product Pricing

Customer Form Processing

Invoice Generation

API Reference

Helpers Class

The main entry point for all helper functions.

Methods

tax(float|int $total, bool $includedTax = true): TaxService

Creates a tax calculation service for Indonesian PPN (11%).

Parameters:

• $total - The amount to calculate tax for
• $includedTax - Whether the total includes tax (default: true)

Returns: TaxService instance with calculated values

rupiah(float|int $amount): string

Formats a number as Indonesian Rupiah currency.

Parameters:

• $amount - The amount to format

Returns: Formatted currency string with "Rp " prefix

terbilang(float|int $amount): string

Converts a number to Indonesian words (terbilang).

Parameters:

• $amount - The number to convert to words

Returns: Indonesian text representation with "rupiah" suffix

rupiah_to_number(string|int|float $value): int|float

Parses Indonesian currency strings back to numbers.

Parameters:

• $value - Currency string, number, or numeric value to parse

Returns: Numeric value (int or float based on decimal presence)

to_e164(string $phone, string $countryCode = '62'): string

Formats phone numbers to E.164 international format.

Parameters:

• $phone - Phone number to format
• $countryCode - Country code (default: '62' for Indonesia)

Returns: E.164 formatted phone number with "+" prefix

TaxService Class

Handles tax calculations with the following public properties:

• $basePrice - The original price before tax
• $tax - The calculated tax amount
• $taxedPrice - The final price including tax

Facade Usage

Configuration

The package uses a fixed 11% tax rate for Indonesian PPN. This rate is hardcoded in the TaxService class and reflects the current Indonesian tax law.

Error Handling

The package handles common edge cases:

• Negative amounts: Supported for refunds and adjustments
• Decimal precision: Amounts are rounded to nearest integer for IDR
• Zero amounts: Properly handled in both tax and currency formatting
• Large numbers: No arbitrary limits on calculation amounts

Performance Considerations

• Tax calculations use simple arithmetic operations (very fast)
• Currency formatting uses PHP's built-in number_format() function
• No external API calls or database queries
• Suitable for high-traffic applications

Compatibility

• PHP: 8.3+
• Laravel: 10.x, 11.x, 12.x
• Framework: Laravel package, but core classes can work standalone

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Rupadana
• All Contributors

License

The MIT License (MIT). Please see License File for more information.