> For the complete documentation index, see [llms.txt](https://docs.adminplus.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adminplus.dev/paid-scripts/qb-esx-business-promotion-paid.md).

# \[QB/ESX] Business Promotion \[PAID]

<figure><img src="/files/QUk6jOcLxnBCSuLpbBKz" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This script allows you to do /promotion (text) with the required job & job role that will then display a notification on screen to everybody in the server, in regards to promoting their business to announce anything (event/business opening etc..)

<img src="https://dunb17ur4ymx4.cloudfront.net/wysiwyg/1233912/b18993e78e861aef3a312e922499e6d7515237e7.png" alt="" data-size="original">
{% endhint %}

<figure><img src="/files/DFHJUGMsoanVW7HQYe8v" alt=""><figcaption></figcaption></figure>

* <mark style="color:orange;">Configurable allowed jobs.</mark>
* <mark style="color:orange;">Configurable promotional costs for each job.</mark>
* <mark style="color:orange;">Configurable job grade to be able to promote.</mark>
* <mark style="color:orange;">Configurable text (language).</mark>
* <mark style="color:orange;">Configurable blacklisted words in message.</mark>
* <mark style="color:orange;">Configurable cooldown.</mark>
* <mark style="color:orange;">Configurable amber-alert.</mark>

> /promotion (text) - display notification to everybody in the city.

```
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
```

<figure><img src="/files/LhinZZRSRrF3cHV4BUcL" alt=""><figcaption></figcaption></figure>

* This resource is drag/drop. Make sure to choose your framework inside of the config. You will just need to add the following inside of your server.cfg after you've dropped the file into your resources.

> <mark style="color:orange;">ensure adminplus-promotion</mark>

{% hint style="warning" %}
Feel free to check the config.lua & customize what jobs have access, the job grade, the pricing & also the cooldown.
{% endhint %}

```lua
-- ███████████████████████████████████████████████████████████████████████████ --                                                                                                                                  

Config = {}

Config.Framework = 1 -- (ESX == 1), (QB == 2)
Config.FrameworkExport = 'es_extended' -- (ESX == 'es_extended'), (QB == 'qb-core' - if QB comment the es_extended line in shared_scripts in fxmanifest.lua, add -- before the '@es_extended')

-- Ox_lib notification to everybody
Config.Ox_LibNotify = false
Config.ChatMessage = true

-- position?: 'top' or 'top-right' or 'top-left' or 'bottom' or 'bottom-right' or 'bottom-left' or 'center-right' or 'center-left'
Config.NotifyPosition = 'bottom-right'
Config.Icon = 'business-time'
Config.BusinessIcon = 'rectangle-ad'

-- LBPHONE EMERGENCY ALERT INTEGRATION
Config.EmergencyAlert = false -- player must have phone to receive the messages
Config.EmergencyAlertCommand = 'emergencyalert'
Config.AuthorizedJobs = { -- list of jobs that can use the command and required grade
    [1] = {job = 'police', grade = 0},
    --[2] = {job = 'ambulance', grade = 0},
}

---

-- I recommend to choose one of these.
Config.LbPhone = {
  Birdy = false,
  InstaPic = false,
  YellowPages = false,
  Marketplace = false,
  Mail = false,
}

Config.AllowedJobs = {
  ["rea"] = true,
  ["mechanic"] = true,
}

Config.RequiredGrade = {
  ["rea"] = 3,
  ["mechanic"] = 0,
}

Config.PromotionCosts = {
  ["rea"] = 100,
  ["mechanic"] = 150,
}

Config.BlacklistWords = {
  "nigger",
  "niggr",
  "n1gger",
  "n1gg3r",
  "ngger",
  "n1ger",
  "n1g3r",
  "nigg3r",
  "ng3r",
  "nger",
  "faggot",
  "f@gg0t",
  "fag",
  "f@g",
  "fag0t",
  "fagot",
  "fagg0t",
  -- Add more blacklist words here
}

Config.CooldownTime = 0  -- Cooldown time in seconds

Config.Strings = {
  emergency_alert = 'Emergency Alert',
  you_are_not_allowed_emergencyalert = 'You are not allowed to use emergency-alert.',
  business_promotion = 'Business Promotion',
  -- This one is for server-side that will show job name next to it.
  business_promotion2 = 'Business Promotion - ',
  job = 'Job: ',
  wait_for_promotion = 'Please wait before promoting your business again.',
  blacklisted_words = 'Your message contains a blacklisted-word.',
  not_enough_money = 'You do not have enough money to promote your business.',
  not_required_job_grade = 'You do not have the required job grade to promote your business.',
  you_are_not_allowed = 'You are not allowed to promote your business.',
  not_enough_cash = 'You do not have enough cash.',
  player_not_found = 'Player not found.'
}

-- ███████████████████████████████████████████████████████████████████████████ --
```

```
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
```

<figure><img src="/files/cSa9GTZM3fGHbSakyouX" alt=""><figcaption></figcaption></figure>

```markup
V 1.0.0
```

* Original Release

```
v 1.0.1
```

> Integrated LB-Phone into my promotion script. Added optional features with what you want to display whether its Ox\_Lib notification or notify your business through the phone itself on specific apps of your choice in the Config. There is additional features you can check on the docs. ./promote (msg) , will automatically promote your message to the chosen application & display on the phone. It will not be saved under your account as a tweet, but will be displayed.
>
> * You can enable/disable which apps would show the notification.

> Added configuration to where you want the notify to display.
>
> ```
> position?: 'top' or 'top-right' or 'top-left' or 'bottom' or 'bottom-right' or 'bottom-left' or 'center-right' or 'center-left'
> ```

{% embed url="<https://i.gyazo.com/c492c0621acbfdf974308dbd477c24b7.png>" fullWidth="false" %}

{% embed url="<https://i.gyazo.com/057c82334ac29c1228e467c43245c908.jpg>" fullWidth="false" %}

```
V 1.0.2
```

> Integrated Amber Alert for LB-PHONE

<figure><img src="/files/AXNn4SCWyFRZCo1PB4ci" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/B4fW5XXW7ZMme5yqtpyD" alt=""><figcaption></figcaption></figure>

```
V 1.0.3
```

> Integrated Chat message Config option to turn/disable. You can now enable wether you want the lib.notification on the right or a chat message top-left.

> Added editable fas-fa-icon Config Option.

<figure><img src="https://i.gyazo.com/74a63c58af5759b376abc5f4a63bfcf0.png" alt=""><figcaption></figcaption></figure>

```
V 1.0.6
```

> Optimized code (removed useless callbacks & unnecessary code). - best for medium-large servers.

> Fixed up events/exports for lb-phone (emergency \[amber-alert] & renamed applications to TOS-COMPLIANT names like Twitter -> Birdy & Instagram -> InstaPic

<mark style="color:$danger;">Changed Files:</mark>

* adminplus-promotion/ALL FILES

```
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
```

<figure><img src="/files/GICvWvhe7QLANSUPz86h" alt=""><figcaption></figcaption></figure>

* [<mark style="color:yellow;">Forums Post</mark>](https://forum.cfx.re/t/esx-business-advertisement-promote-your-job-city-wide-configurable-options/5125654)
* [<mark style="color:yellow;">Showcase (video)</mark>](https://youtu.be/dZgys_o97JY)
* [<mark style="color:yellow;">Tebex (purchase)</mark>](https://adminplus.tebex.io/package/5739940)
* [<mark style="color:yellow;">Support (discord)</mark>](https://discord.gg/J2mP9kJJ83)