1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/ofancn-invoice

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
README.md 10 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 28.11.2024 11:21 c64c941

Invoice

Английский документ

Китайский традиционный документ

Всего несколько строк кода позволят вам создать изысканный счёт или заказ. Используйте свои собственные логотипы и фирменные цвета, чтобы сделать счёт уникальным. Автоматическое разбиение на страницы позволяет добавлять неограниченное количество позиций и итоговых строк. Вы можете отправить PDF-файл пользователю в браузере, сохранить его на сервере или принудительно загрузить файл. Invoice поддерживает перевод на китайский упрощённый, китайский традиционный и английский языки. Вы можете настроить валюту для каждого документа.

Проект уже интегрирован с Source Han Sans, китайской версией шрифта.

Установка Invoice

Invoice использует Composer для управления зависимостями. Поэтому перед использованием Invoice убедитесь, что у вас установлен Composer на вашем компьютере.

composer require invoice/invoice

Демонстрация

Пример счёта Apple

Валюта

Код валюты

Документы

Пример

use Invoice\Invoice;
$invoice=new Invoice();

или

$invoice=get_invoice();

Пример использования

$invoice = new Invoice('CNY','A4');

//Set number formatting
$invoice->setNumberFormat('.',',')

//设置字体
//->setFontFamily('SourceHanSans', '', '~/font/sourcehansans.ttf')
//->setFontFamily('SourceHanSans','b', '~/font/sourcehansansb.ttf')

//设置LOGO
->setLogo("images/apple.png",100,88)
//设置颜色
->setColor("#ed4014")
//设置要文档类型
->setType("счёт")
//设置文档编号
->setReference(date('Ymd').'001')
//Счётная дата
->setDate(date('Y-m-d'))
//Срок оплаты
->setDue(date('Y-m-d',strtotime('+3 months')))
//Отправитель
->setFrom(["Apple Inc","1 Infinite Loop","Cupertino, CA 95014","United States of America","IE9700053D"])
//Клиент
->setTo(["京东商城 刘强东","北京市","北京经济技术开发区科创","十四街99号2号楼B168室","400-6065500 "])
//Новый продукт
->addItem("Apple iPhone X","64G красный",1,"21%",299,'5%',284.05)
->addItem("Apple iPhone X","158G красный",1,"21%",299,0,299)
//Добавить итог
->addTotal("Итого",583.05)
->addTotal("Скидка 21%",122.44)
->addTotal("Всего",705.5,true)
//Добавление заявления
->addTitle("Заявление")
//Добавление абзаца
->addParagraph("Всего несколько строк кода позволяют создавать изысканные счета или заказы\nInvoice использует Composer для управления своими зависимостями. Поэтому, прежде чем использовать Invoice, убедитесь, что Composer установлен на вашем компьютере\ncomposer require invoice/invoice")
//Установка нижнего колонтитула
->setFooternote("http://www.apple.com")
//Добавление значка
->addBadge('Уровень секретности A')
//Переключение информации о компании и клиенте
->flipflop()
//Создание PDF
->render('Apple.pdf','I');

Описание класса

    /**
     * Пример
     * @param string $currency
     *            Код валюты
     * @param string $size
     *            Размер бумаги A4 Letter Legal
     * @param string $language
     *            Язык
     */
    function __construct($currency = 'CNY', $size = 'A4', $language = 'zh');

    /**
     * Получить символ валюты
     *
     * @param string $code
     *            Валютный код
     * @return string|null
     */
    public function getCurrencySymbol(string $code);

    /**
     * Проверить, можно ли использовать валюту
     *
     * @param string $code
     *            Валютный код
     * @return bool
     */
    public function hasCurrency(string $code);

    /**
     * Установить шрифт
     *
     * @param string $family
     *            Название шрифта
     * @param string $style
     *            Стиль шрифта, должен содержать как минимум два стиля шрифта ''и'b'
     * @param string $file
     *            Файл шрифта
     * @return $this
     */
    public function setFontFamily(string $family, string $style = '', string $file = '');

    /**
     * Установить язык
     *
     * @param string $language
     * @return $this
     */
    public function setLanguage(string $language);

    /**
    * Установить тип документа
    *
    * @param type $title
    * @return $this
    */
    public function setType(string $title);

    /**
     * Установить цвет
     *
     * @param string $rgbcolor
     *            Шестнадцатеричный код цвета. Пример красного цвета: '#FF0000'
     * @return $this
     */
    public function setColor(string $rgbcolor);

    /**
     * Установить дату документа
     *
     * @param string $date
     * @return $this
     */
    public function setDate(string $date);

    /**
     * Срок оплаты
     *
     * @param string $date
     * @return $this
     */
    public function setDue(string $date);

    /**
     * Установить логотип
     *
     * @param string $logo
     *            Путь к локальному файлу изображения или удалённый URL
     * @param int $maxWidth
     *            Ширина в миллиметрах
     * @param int $maxHeight
     *            Высота в миллиметрах
     * @return $this
     */
    public function setLogo($logo = 0, $maxWidth = 0, $maxHeight = 0);

    /**
     * Установить информацию о компании
     *
     * @param array $data
     * @return $this
     */
    public function setFrom(array $data);

    /**
     * Информация о клиенте
     *
     * @param array $data
     * @return $this
     */
    public function setTo(array $data);

    /**
     * Установить номер документа
     *
     * @param string $reference
     * @return $this **Вот перевод текста на русский язык:**

    /**
     * Устанавливает ссылку.
     */
    public function setReference($reference);

    /**
     * Устанавливает числовой формат.
     *
     * @param string $decimals
     *            Символ десятичной точки.
     * @param string $thousands_sep
     *            Разделительный символ тысяч.
     * @return $this
     */
    public function setNumberFormat($decimals, $thousands_sep);

    /**
     * Добавляет товар.
     *
     * @param string $item
     *            Название продукта или услуги.
     * @param string $description
     *            Описание с использованием <br> или \n для добавления переноса строки.
     * @param decimal $quantity
     *            Количество.
     * @param decimal|string $vat
     *            Сумма.
     * @param decimal $price
     *            Цена за единицу.
     * @param string|decimal|boolean $discount
     *            Скидка. Если нет, то false.
     * @param int $total
     *            Общая сумма.
     * @return $this
     */
    public function addItem($item, $description, $quantity, $vat, $price, $discount, $total);

    /**
     * Устанавливает общую сумму.
     *
     * @param string $name
     *            Имя.
     * @param decimal $value
     *            Значение.
     * @param boolean $colored
     *            Цвет фона. true — цвет фона.
     * @return $this
     */
    public function addTotal($name, $value, $colored = false);

    /**
     * Добавляет заголовок.
     *
     * @param string $title
     * @return $this
     */
    public function addTitle($title);

    /**
     * Добавляет абзац.
     *
     * @param string $paragraph
     * @return $this
     */
    public function addParagraph($paragraph);

    /**
     * Добавляет значок.
     *
     * @param string $badge
     * @return $this
     */
    public function addBadge($badge);

    /**
     * Устанавливает примечание в нижнем колонтитуле.
     *
     * @param string $note
     * @return $this
     */
    public function setFooternote($note);

    /**
     * Меняет местами горизонтальное положение информации о компании и информации о клиенте.
     *
     * @return $this
     */
    public function flipflop();

    /**
     * Рендерит доставку.
     *
     * @param string $name
     *            Имя.
     * @param string $destination
     *            Способ доставки.
     *            I (встраивает файл в браузер).
     *            D (отправляет файл в браузер и принудительно загружает его с заданным именем).
     *            F (сохраняет файл локально. Убедитесь, что в параметре name указан путь к файлу).
     *            S (возвращает документ в виде строки).
     * @return $this
     */

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/ofancn-invoice.git
git@api.gitlife.ru:oschina-mirror/ofancn-invoice.git
oschina-mirror
ofancn-invoice
ofancn-invoice
master