nbtools — это библиотека для обычных маркетинговых работ в сфере электронной коммерции.

Эта документация посвящена использованию функции nbtools и ее установке.

Монтаж

nbtools — это настраиваемая работа с javascript, поэтому вы должны добавить ее в свои проекты как глобальный уровень области видимости.

Скачать скрипт можно отсюда → nbtools.js

Применение

nbtools в настоящее время имеет 10 функций;

  1. toastAlert
  2. неожиданно возникнуть
  3. страницаСчетчик
  4. между датами
  5. возвращающийся пользователь
  6. новый пользователь
  7. в день
  8. мобильныйПроверить
  9. получить время
  10. толькоTr

1.toastAlert

nbtools toastAlert позволяет создавать оповещения для пользователя.

параметры:

  1. Текст предупреждения:
    Тип: string
    Требование: required
    Описание: Your alert message
  2. Тип предупреждения:
    Тип: string
    Требование: optionally(default value: success)
    Значения: 'success','fail','info','warning'
    Описание: Defines alert color and icon
  3. Позиция оповещения:
    Тип: string
    Требование: optionally(default value: bottom-left)
    Значения: 'bottom-left' , 'bottom-right' , 'mid-left' , 'mid-right' , 'top-left' , 'top-right'
    Описание: Defines alert position on screen
  4. Время исчезновения предупреждения:
    Тип: String/number
    Требование: optionally(default value: 2 second)

Пример:

nbtools («toastAlert», «купон кода kaydedildi!», «успех», «нижний левый», 3);

nbtools («toastAlert», «Hata oluştu!», «fail», «внизу справа»);

2. всплывающее окно

nbtools «popup» позволяет вам создать базовое всплывающее окно в середине экрана.

параметры:

  1. Ссылка на всплывающее изображение:
    Тип: string
    Требование: required
    Описание: Your main image link (desktop)
  2. Настройки всплывающего окна:
    Тип: object

значения объекта настроек всплывающего окна

1.mobile_image
Type: string

  • Если у вас есть другое изображение для мобильных устройств, вы должны указать ссылку на него как свойство mobile_image. Если вы собираетесь использовать одно и то же изображение для рабочего стола и мобильного устройства, вам не нужно использовать это свойство.

2.ширина
Type: string/number

  • С помощью этого свойства вы можете установить ширину изображения в пикселях.

3.высота
Type: string/number

  • С помощью этого свойства вы можете установить высоту изображения в пикселях.

4.mobile_with
Type: string/number

  • С помощью этого свойства вы можете установить ширину мобильного изображения в пикселях.

5.мобильная_высота
Type: string/number

  • С помощью этого свойства вы можете установить высоту мобильного изображения в пикселях.

6.id
Type: string

  • Вы можете указать идентификатор своего всплывающего окна, чтобы заблокировать конфликты.

7.ссылка
Type: string

  • Вы можете дать ссылку перенаправления на ваше всплывающее окно.

8.button_color
type: string

  • Вы можете установить цвет кнопки закрытия как имена цветов css, код цвета rgb или шестнадцатеричный код цвета.

Пример:

nbtools («всплывающее окно», https://cdn.pixabay.com/photo/2022/11/13/18/44/grey-wolf-7589920_640.jpg,{

mobile_image:”https://cdn.pixabay.com/photo/2022/11/13/18/44/grey-wolf-7589920_640.jpg,

ширина: 200,

высота: 200,

мобильная_ширина: 100,

мобильная_высота: 100,

идентификатор: «мое первое всплывающее окно»,

ссылка: https://github.com/Berknb/nbtools',

button_color: «черный»

});

3. счетчик страниц

«pageCounter» позволяет подсчитать, сколько страниц просмотрел пользователь. Когда он достигает предела, он возвращает true.

  • тип возвращаемого значения: boolean

параметры:

  1. Ограничение счетчика:
    Тип: string/number
    Требование: required
    Описание: defines how many pages the user should browse to return true
  2. id:
    Тип: string/number
    Требование: optionally
    Описание: You can give an id to your pageCounter to block conflicts with other pageCounters.

Пример:

nbtools ("pageCounter", 2, "выход-счетчик намерений")

4.betweenDates

«betweenDates» проверяет, является ли текущее местное время в пределах введенных диапазонов дат.

Вы можете указать две даты, чтобы выбрать диапазон дат по индивидуальному заказу.

также вы можете указать первый параметр как дату, и вы можете выбрать второй как «конец» или «начало», чтобы определить дату начала или окончания первого параметра.

  • тип возвращаемого значения: boolean

параметры:

  1. Дата начала:
    Тип: string
    Требование: required
    Описание: defines first date of dates range.
    Синтаксис: 'dd/mm/yy-hours:minutes:seconds'
  2. Дата окончания:
    Тип: string
    Требование: required
    Описание: Define
    Значения:
    1.date input: 'dd/mm/yy-hours:minutes:seconds'
    2.'end'
    3.'start'

Пример:

nbtools("betweenDates", "23.11.2022–01:55:00", 24.11.2022–01:55:00);

nbtools («между датами», «23.11.2022–01:55:00», «конец»);

5.returningUser

«returningUser» определяет, что пользователь не впервые просматривает веб-сайт.

  • тип возвращаемого значения: boolean

параметры:

  1. id:
    Тип: string/number
    Требование: optionally
    Описание: You can give an id to your 'returningUser' to block conflicts with other 'returningUser'.

Пример:

nbtools («возвращающийся пользователь»);

nbtools («returningUser», «домашняя страница-returninguser»);

6.newUser

«newUser» определяет, что пользователь впервые просматривает веб-сайт.

  • тип возвращаемого значения: boolean

параметры:

  1. id:
    Тип: string/number
    Требование: optionally
    Описание: You can give an id to your 'newUser' to block conflicts with other 'newUser'.

Пример:

nbtools («новый пользователь»);

nbtools («новый пользователь», «cartpage-newuser»);

7. perDay

perDay — это 24-часовой счетчик. Как только вы вызовете perDay, через 24 часа он вернет true и повторит этот процесс снова.

Вы также можете использовать счетчик часов, если вы укажете «часы» в качестве второго параметра.

  • тип возвращаемого значения: boolean

параметры:

1.дни или часы:
Тип: number
Требование: optionally
Описание: You can define how many days or hours you want to set cooldown.
Значение по умолчанию: 1 day

2. часы:
Тип: string
Требование: optionally
Описание: You can define your first parameter count as hours.
По умолчанию: days

3. идентификатор:
Тип: string/number
Требование: optionally
Описание: You can give an id to your 'perDay' to block conflicts with other 'perDay'.

Пример:

nbtools («в день», 3, «часы», «корзина-страница-всплывающее окно»);

nbtools («за день»); /* значение по умолчанию: 1 день */

8.mobileCheck

«mobileCheck» проверяет, является ли пользовательское устройство мобильным или нет.

  • тип возвращаемого значения: boolean

Пример:

nbtools («мобильная проверка»);

9. получить время

getTime преобразует дату в метку времени в миллисекундах.

  • тип возвращаемого значения: number

параметры:

  1. Дата:
    Тип: string
    Требование: required
    Описание: the date you want to convert
    Синтаксис даты: dd/mm/yy-hours:minutes:seconds

Пример:

nbtools («getTime», 21.11.2022–09:00:00)

10.onlyTr

‘onlyTr’ проверяет часовой пояс пользователя и возвращает ли пользователь в Турции значение true.

  • тип возвращаемого значения: boolean

Пример:

нбтулс («только Тр»);

Кто бы ни использовал nbtools, да пребудет с ним сила