Приложение "Экспорт в PDF": различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
(Новая страница: «Приложение предназначено для экспорта объявлений в формат PDF.<br /> Файлы PDF легко распечат…»)
 
 
(не показано 14 промежуточных версий 1 участника)
Строка 1: Строка 1:
Приложение предназначено для экспорта объявлений в формат PDF.<br />
+
== Назначение ==
Файлы PDF легко распечатать на принтере.<br />
+
Приложение предназначено для организации экспорта объявлений в формат PDF-документа, которые, зачастую, более удобны при распространении и печати.<br />
<br />
+
Приложение поддерживает создание собственных макетов документов, что позволяет определить свой уникальный стиль подачи материала<br />
 +
Создание макета может потребовать некоторых базовых знаний в области создания разметки HTML и использования стилей CSS, либо привлечения специалиста. Не сложные макеты могут быть сверстаны самостоятельно на основании базового.
  
'''Установка'''<br />
+
== Установка ==
 
# Распакуйте архих pdfreport.zip  
 
# Распакуйте архих pdfreport.zip  
 
# Скопируйте каталог pdfreport по ftp в каталог сайта /apps/  
 
# Скопируйте каталог pdfreport по ftp в каталог сайта /apps/  
Строка 9: Строка 10:
 
# Зайдите в настройки и в закладке PDF Report поставьте 1 в поле Включить PDF экспорт  
 
# Зайдите в настройки и в закладке PDF Report поставьте 1 в поле Включить PDF экспорт  
 
# В шаблоне realty_view.tpl в удобном месте поставьте вот такую кнопку <br />
 
# В шаблоне realty_view.tpl в удобном месте поставьте вот такую кнопку <br />
 +
<pre>
 +
{if $apps_pdfreport_enabled==1}
 +
<div class="es">
 +
    <a href="?format=pdf" class="btn">
 +
        <i class="icon icon-print"></i> Печать
 +
    </a>
 +
</div>
 +
{/if}
 +
</pre>
 
<br />
 
<br />
 +
Если вы хотите сделать свой формат PDF документа, то вам нужно скопировать шаблон генерации документа<br />
 +
<pre>/apps/pdfreport/admin/template/realty_view.tpl</pre>
 +
сюда<br />
 +
<pre>/template/frontend/ваша_тема/apps/pdfreport/realty_view.tpl</pre>
 +
<br />
 +
 +
Изменяя этот файл вы сможете добавить собственные стили отображения, контактные данные и логотип компании.
 +
 +
== Использование шаблонов генерирования ==
 +
При создании PDF используется следующий алгоритм использования шаблонов<br /><br />
 +
 +
1. Запуск создания PDF происходит по запросу адреса просмотра карточки объекта <nowiki>http://domain/realty385?format=pdf</nowiki>. Вместе с переменной запроса format может передаваться дополнительная переменная tpl, которая содержит имя конкретного шаблона для создания DPF-документа. Имя файла шаблона передается в виде имени файла без расширения.<br /><br />
 +
 +
2. Если переменная tpl не передана, то шаблоном будет считаться файл realty_view.tpl расположенный в<br />
 +
 +
- папке /template/frontend/ваш_шаблон/apps/pdfreport/<br />
 +
 +
- папке /apps/pdfreport/admin/template/<br />
 +
 +
Папки перечислены в порядке, в котором будет проводиться проверка наличия указанного файла.<br /><br />
 +
 +
3. Если переменная tpl передана, то будет предпринята попытка найти файл с таким именем в<br />
 +
 +
- папке /template/frontend/ваш_шаблон/apps/pdfreport/<br />
 +
 +
- папке /apps/pdfreport/admin/template/<br />
 +
 +
Если после этого файл не будет найден, то шаблоном будет назначен файл один из существующих файлов (тот, который будет найден первым)<br />
 +
 +
- папке /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl<br />
 +
 +
- папке /apps/pdfreport/admin/template/realty_view.tpl<br /><br />
 +
 +
 +
Иными словами, вызываю генерирование DPF-документа вы гарантировано получите документ по шаблону /apps/pdfreport/admin/template/realty_view.tpl<br />
 +
 +
=== Пример ===
 +
Запросив <nowiki>http://domain/realty385?format=pdf</nowiki> вы получите сгенерированный документ на основании макета из /apps/pdfreport/admin/template/realty_view.tpl<br />
 +
 +
 +
Если у вы создадите в шаблоне файл /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl, то по этому же запросу вы получите документ на основании макета из /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl<br />
 +
  
 +
Запросив <nowiki>http://domain/realty385?format=pdf&tpl=my_pdf_layout</nowiki> будет отдан документ на основании макета<br />
  
<small>{if $apps_pdfreport_enabled==1}
+
/template/frontend/ваш_шаблон/apps/pdfreport/my_pdf_layout.tpl<br />
<div class="es"><a href="?format=pdf" class="btn"><i class="icon icon-print"></i> Печать</a></div>
+
 
{/if}
+
либо, если его нет,<br />
</small><br />
+
 
 +
/apps/pdfreport/admin/template/my_pdf_layout.tpl<br />
 +
 
 +
либо, если его нет,<br />
 +
 
 +
/template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl<br />
 +
 
 +
либо, если его нет,<br />
 +
 
 +
/apps/pdfreport/admin/template/realty_view.tpl<br />
 +
== Макеты ==
 +
Макеты для генерации документов PDF должны иметь расширение tpl, могут иметь в названии латинские буквы, цифры и подчеркивания.<br />
 +
 
 +
По сути, макет - это обычная законченная html-страница, которая должна включать все обязательные элементы разметки (html, head, body). Разметка должна быть валидной - все открытые теги, требующие закрываюего, должны быть закрыты.
 
<br />
 
<br />
Если вы хотите сделать свой формат PDF документа, то вам нужно скопировать шаблон генерации документа<br />
 
<small>/apps/pdfreport/admin/template/realty_view.tpl</small><br />
 
  
сюда<br />
+
Макет должен включать в себя ссылки на ВСЕ необходимые ему для построения таблицы стилей и библиотеки. Сылки могут быть абсолютными, либо относительными. Для относительных необходимо использовать переменную '''{$_core_folder}''' для правильного ссылания на корень сайта. Логика указания ссылок на таблицы стилей аналогична и для указания источников изображений<br />
<small>/template/frontend/ваша_тема/apps/pdfreport/realty_view.tpl</small><br /><br />
+
 
 +
== Шрифты ==
 +
 
 +
Приложение поддерживает следующие значения для font-family в стилях шаблона
 +
 
 +
arial (стоит отдавать предпочтение arialcyr)
 +
 
 +
arialcyr
 +
 
 +
verdana
 +
 
 +
sans-serif - не поддерживает кириллицу
 +
 
 +
times - не поддерживает кириллицу
 +
 
 +
times-roman - не поддерживает кириллицу
 +
 
 +
courier - не поддерживает кириллицу
 +
 
 +
helvetica - не поддерживает кириллицу
 +
 
 +
zapfdingbats - не поддерживает кириллицу
 +
 
 +
symbol - не поддерживает кириллицу
 +
 
 +
serif - не поддерживает кириллицу
 +
 
 +
monospace - не поддерживает кириллицу
 +
 
 +
fixed - не поддерживает кириллицу
 +
 
 +
dejavu sans (оптимальный без засечек)
 +
 
 +
dejavu sans mono
 +
 
 +
dejavu serif (оптимальный с засечками)
 +
 
 +
robotocondenced - поддержка данного шрифта не окончательна и может быть отменена
 +
 
 +
== Опции листа на распечатку: ==
 +
\apps\third\vendor\dompdf\dompdf\src\Options.php<br>
 +
 
 +
''Параметры к правке:''
 +
private $defaultPaperSize = "a4";<br>
 +
private $defaultPaperOrientation = "landscape";<br>
  
В этом новом файле вы можете добавить свои контактные данные и логотип компании.
+
== Список форматов листа: ==
 +
\apps\pdfreport\lib\dompdf\include\cpdf_adapter.cls.php

Текущая версия на 05:39, 24 апреля 2019

Назначение

Приложение предназначено для организации экспорта объявлений в формат PDF-документа, которые, зачастую, более удобны при распространении и печати.
Приложение поддерживает создание собственных макетов документов, что позволяет определить свой уникальный стиль подачи материала
Создание макета может потребовать некоторых базовых знаний в области создания разметки HTML и использования стилей CSS, либо привлечения специалиста. Не сложные макеты могут быть сверстаны самостоятельно на основании базового.

Установка

  1. Распакуйте архих pdfreport.zip
  2. Скопируйте каталог pdfreport по ftp в каталог сайта /apps/
  3. Зайдите в админку в пункт Приложения - PDF Report (будет выполнена первичная инициализация приложения)
  4. Зайдите в настройки и в закладке PDF Report поставьте 1 в поле Включить PDF экспорт
  5. В шаблоне realty_view.tpl в удобном месте поставьте вот такую кнопку
{if $apps_pdfreport_enabled==1}
<div class="es">
    <a href="?format=pdf" class="btn">
        <i class="icon icon-print"></i> Печать
    </a>
</div>
{/if}


Если вы хотите сделать свой формат PDF документа, то вам нужно скопировать шаблон генерации документа

/apps/pdfreport/admin/template/realty_view.tpl

сюда

/template/frontend/ваша_тема/apps/pdfreport/realty_view.tpl


Изменяя этот файл вы сможете добавить собственные стили отображения, контактные данные и логотип компании.

Использование шаблонов генерирования

При создании PDF используется следующий алгоритм использования шаблонов

1. Запуск создания PDF происходит по запросу адреса просмотра карточки объекта http://domain/realty385?format=pdf. Вместе с переменной запроса format может передаваться дополнительная переменная tpl, которая содержит имя конкретного шаблона для создания DPF-документа. Имя файла шаблона передается в виде имени файла без расширения.

2. Если переменная tpl не передана, то шаблоном будет считаться файл realty_view.tpl расположенный в

- папке /template/frontend/ваш_шаблон/apps/pdfreport/

- папке /apps/pdfreport/admin/template/

Папки перечислены в порядке, в котором будет проводиться проверка наличия указанного файла.

3. Если переменная tpl передана, то будет предпринята попытка найти файл с таким именем в

- папке /template/frontend/ваш_шаблон/apps/pdfreport/

- папке /apps/pdfreport/admin/template/

Если после этого файл не будет найден, то шаблоном будет назначен файл один из существующих файлов (тот, который будет найден первым)

- папке /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl

- папке /apps/pdfreport/admin/template/realty_view.tpl


Иными словами, вызываю генерирование DPF-документа вы гарантировано получите документ по шаблону /apps/pdfreport/admin/template/realty_view.tpl

Пример

Запросив http://domain/realty385?format=pdf вы получите сгенерированный документ на основании макета из /apps/pdfreport/admin/template/realty_view.tpl


Если у вы создадите в шаблоне файл /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl, то по этому же запросу вы получите документ на основании макета из /template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl


Запросив http://domain/realty385?format=pdf&tpl=my_pdf_layout будет отдан документ на основании макета

/template/frontend/ваш_шаблон/apps/pdfreport/my_pdf_layout.tpl

либо, если его нет,

/apps/pdfreport/admin/template/my_pdf_layout.tpl

либо, если его нет,

/template/frontend/ваш_шаблон/apps/pdfreport/realty_view.tpl

либо, если его нет,

/apps/pdfreport/admin/template/realty_view.tpl

Макеты

Макеты для генерации документов PDF должны иметь расширение tpl, могут иметь в названии латинские буквы, цифры и подчеркивания.

По сути, макет - это обычная законченная html-страница, которая должна включать все обязательные элементы разметки (html, head, body). Разметка должна быть валидной - все открытые теги, требующие закрываюего, должны быть закрыты.

Макет должен включать в себя ссылки на ВСЕ необходимые ему для построения таблицы стилей и библиотеки. Сылки могут быть абсолютными, либо относительными. Для относительных необходимо использовать переменную {$_core_folder} для правильного ссылания на корень сайта. Логика указания ссылок на таблицы стилей аналогична и для указания источников изображений

Шрифты

Приложение поддерживает следующие значения для font-family в стилях шаблона

arial (стоит отдавать предпочтение arialcyr)

arialcyr

verdana

sans-serif - не поддерживает кириллицу

times - не поддерживает кириллицу

times-roman - не поддерживает кириллицу

courier - не поддерживает кириллицу

helvetica - не поддерживает кириллицу

zapfdingbats - не поддерживает кириллицу

symbol - не поддерживает кириллицу

serif - не поддерживает кириллицу

monospace - не поддерживает кириллицу

fixed - не поддерживает кириллицу

dejavu sans (оптимальный без засечек)

dejavu sans mono

dejavu serif (оптимальный с засечками)

robotocondenced - поддержка данного шрифта не окончательна и может быть отменена

Опции листа на распечатку:

\apps\third\vendor\dompdf\dompdf\src\Options.php

Параметры к правке: private $defaultPaperSize = "a4";
private $defaultPaperOrientation = "landscape";

Список форматов листа:

\apps\pdfreport\lib\dompdf\include\cpdf_adapter.cls.php