PHPackages valinteca-test/localization - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. valinteca-test/localization ActiveLibrary[Localization & i18n](/categories/localization) valinteca-test/localization =========================== valinteca test localization 1.0.4(2y ago)010MITPHPPHP ^8.0 Since May 6Pushed 2y ago1 watchersCompare [ Source](https://github.com/kareem-torky/valinteca-test-locale)[ Packagist](https://packagist.org/packages/valinteca-test/localization)[ RSS](/packages/valinteca-test-localization/feed)WikiDiscussions main Synced today READMEChangelog (4)Dependencies (1)Versions (5)Used By (0) Localization package -------------------- [](#localization-package) A composer package from Valinteca that introduces an easy integration with [Localization](https://www.Localization.com/index.php?lang=Ar) platform for Laravel applications. Features -------- [](#features) - Send SMS messages - Send personalized messages - Send & verify OTP codes - Manage senders - Message cost calculation - Balance inquiry Installation ------------ [](#installation) ``` composer require valinteca/Localization ``` To publish configurations: ``` php artisan vendor:publish --provider="Valinteca\Localization\LocalizationServiceProvider" ``` This will publish config file to config/Localization.php Then add these keys to .env file: ``` Localization_USERNAME="VALUE_HERE" # From your Localization subscription Localization_API_KEY="VALUE_HERE" # From your Localization subscription Localization_SENDER_NAME="VALUE_HERE" # Custom sender name Localization_LANG="VALUE_HERE" # Language ("En" or "Ar") ``` Usage ----- [](#usage) ``` use Valinteca\Localization\Facades\Localization; ``` ### **Send message** [](#send-message) *to:* acccepts number or array of numbers *at:* accepts time to send in format "Y-m-d H:i:s" or a *Carbon* instance *message:* acccepts message text *send:* performs operation and returns response ***Examples*** - with default settings: ``` Localization::to('05xxxxxxxx') ->message('hello world') ->send(); ``` - Custom sender: Use *sender* method for custom sender name. If you didn't use this method then default sender name from config/env will be used. ``` Localization::sender('another sender') ->to('05xxxxxxxx') ->message('hello world') ->send(); ``` - Multiple numbers: Pass an array to *to* method. ``` Localization::to(['05xxxxxxxx', '05xxxxxxxx']) ->message('hello world') ->send(); ``` - At later time: Pass datetime to *at* method. ``` // Using string datetime format Localization::to('05xxxxxxxx', '05xxxxxxxx') ->message('hello world') ->at('2023-05-01 20:10:05') ->send(); // Using carbon instance Localization::to('05xxxxxxxx', '05xxxxxxxx') ->message('hello world') ->at(now()->addMinutes(5)) ->send(); ``` - Custom options: Pass options to *options* method Available options are: 1- reqBulkId: to get msg id of the bulk (*true* or *false*, default is *false*) 2- msgEncoding: (*UTF8* or *windows-1256*, default is *UTF8*) 3- reqFilter: to filter the duplicated numbers (*true* or *false*, default is *true*) ``` Localization::to('05xxxxxxxx') ->options([ 'reqBulkId' => true, 'msgEncoding' => 'windows-1256', 'reqFilter' => false, ]) ->message('hello world') ->send(); ``` ### **Send personalized messages** [](#send-personalized-messages) Personalized messages are message with different SMS content for each number in array. To send personalized messages use *sendPersonalized* method with an array of variables for each number. Message body should contain the message body including the variables that should be between curly brackets {}. ``` Localization::to(['05xxxxxxxx', '05yyyyyyyy']) ->message('Hello {name}. Your order {order} will be delivered soon') ->sendPersonalized([ ['name' => 'Mohammed', 'order' => '123'], ['name' => 'Ahmed', 'order' => '456'], ]); // Messages: // 05xxxxxxxx: "Hello Mohammed. Your order 123 will be delivered soon" // 05yyyyyyyy: "Hello Ahmed. Your order 456 will be delivered soon" ``` ### **Send test message** [](#send-test-message) You can test Localization API for free . You will get free sms every day . To test service you can send sms using *sendTestMessage* method. This method uses predefined sender name and message text. so you will define numbers only. ``` Localization::to('05xxxxxxxx') ->sendTestMessage(); ``` ### **Balance Inquiry** [](#balance-inquiry) To inquire about your balance use *getBalance* method ``` Localization::getBalance(); ``` ### **Get messages** [](#get-messages) To get messages for bulk ID use *forbulkId* method with *getMessages*. The result is paginated and default return is page 1. ``` Localization::forBulkId('bulk-id-returned-from-send-method') ->getMessages(); ``` To define page number use *page* method: ``` Localization::forBulkId('bulk-id-returned-from-send-method') ->page(2) ->getMessages(); ``` To define limit use *limit* method: ``` Localization::forBulkId('bulk-id-returned-from-send-method') ->page(1) ->limit(5) ->getMessages(); ``` ### **Calculate message cost** [](#calculate-message-cost) ``` Localization::to(['05xxxxxxxx', '05yyyyyyyy']) ->message('this is message') ->calculateCost(); ``` *Response:* ``` { "success": true, "data": { "cost": "3,9" } } ``` ### **Get user balance** [](#get-user-balance) ``` Localization::getBalance(); ``` *Response:* ``` { "success": true, "data": { "balance": "3042.00" } } ``` ### Health Score 22 — LowBetter than 21% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community7 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 4 Last Release 787d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/38352432?v=4)[Kareem M. Fouad](/maintainers/kareem-torky)[@kareem-torky](https://github.com/kareem-torky) --- Top Contributors [![kareem-torky](https://avatars.githubusercontent.com/u/38352432?v=4)](https://github.com/kareem-torky "kareem-torky (5 commits)") ### Embed Badge ![Health badge](/badges/valinteca-test-localization/health.svg) ``` [![Health](https://phpackages.com/badges/valinteca-test-localization/health.svg)](https://phpackages.com/packages/valinteca-test-localization) ``` ### Alternatives [smmoosavi/php-gettext Wrapper for php-gettext by danilo segan. This library provides PHP functions to read MO files even when gettext is not compiled in or when appropriate locale is not present on the system. 1927.0k1](/packages/smmoosavi-php-gettext) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)