Skip to main content
Version: 7.x

PDF Premium

tip

Do prawidłowego działania PDF Premium konieczne jest wykupienie płatnego dodatku YetiForce PDF Premium.

Instrukcję jak to zrobić znajdziesz tutaj: Instrukcja aktywacji YetiForce PDF Premium

W celu prawidłowego działania dodatku YetiForce PDF Premium, konieczne jest pobranie i zainstalowanie silnika Chromium/Chrome. Silnik ten umożliwia zaawansowane renderowanie PDF-ów, zapewniając wysoką jakość dokumentów i pełną zgodność z funkcjami systemu.

Pobranie silnika Chromium/Chrome​

Silnik Chromium należy pobrać z oficjalnej strony projektu, do której link znajduje się poniżej. Mieszczą się tam również pomocne informacje, instrukcje i linki do najnowszych wersji przeglądarki Chromium, które można zainstalować na swoim systemie.

Configuring the PDF generator path​

By zapewnić prawidłowe generowanie dokumentów PDF w YetiForce, konieczne jest skonfigurowanie ścieżki do generatora PDF. Proces ten obejmuje modyfikację pliku konfiguracyjnego i ustawienie odpowiedniej ścieżki do silnika Chromium/Chrome. Poniżej znajduje się szczegółowa instrukcja dotycząca tej konfiguracji.

Lokalizacja pliku konfiguracyjnego​

Plik konfiguracyjny odpowiedzialny za ustawienia generatora PDF znajduje się w katalogu config/Components/ i nosi nazwę Pdf.php.

PDF configuration file: config/Components/Pdf.php

Ustawienie ścieżki do generatora PDF​

W pliku Pdf.php należy znaleźć parametr $chromiumBinaryPath i ustawić jako jego wartość ścieżkę lokalną do zainstalowanego silnika Chromium/Chrome lub określić polecenie, które uruchamia ten silnik.

/**
 * Configuration file: Config\Components\Pdf.
 */
class Pdf
{
	/**
	 * The name or path of the chrome/chromium engine.
	 *
	 * @see https://www.chromium.org/getting-involved/download-chromium
	 *
	 * @var string
	 */
	public static $chromiumBinaryPath = 'chromium';

	/**
	 * Chromium browser options available for the browser factory.
	 *
	 * @see https://github.com/chrome-php/chrome#available-options
	 *
	 * @var array
	 */
	public static $chromiumBrowserOptions = ['noSandbox' => true, 'noProxyServer' => true];
}

Example $chromiumBinaryPath values:​

  • chromium
  • chromium-browser
  • google-chrome
  • /usr/bin/google-chrome
  • c:\Program Files (x86)\Google\Chrome\Application\chrome.exe
  • c:\ungoogled-chromium\chrome.exe

Wybranie nowego silnika​

W sekcji administracyjnej przejdź w lewym menu do zakładki Narzędzia systemowe a następnie PDF. W celu weryfikacji czy poprawnie skonfigurowano silnik Chromium/Chrome, wybierz przycisk Nowy szablon PDF.

pdf-1.jpg

Gdy ścieżka $chromiumBinaryPath zostanie poprawnie ustawiona i system będzie miał dostęp do lokalizacji/polecenia, pojawi się nowy silnik w polu Silnik generujący.

pdf-2.jpg

Instalacja Chromium na Linuksie przy użyciu skryptu Bash​

W pierwszej kolejności, należy upewnić się czy system ma zainstalowane wszystkie wymagane zależności. Dziękujemy Puppeteer ❤

Lista wymaganych pakietów może się różnić w zależności od dystrybucji i wersji systemu. Dlatego konieczne jest zweryfikowanie potrzebnych zależności pod kątem własnego systemu, w czym może pomóc ta lista: Lista zależności w zależności od wersji

Przykładowa komenda do instalacji zależności dla systemu Debian 12.4 bookworm

apt-get install -y --no-install-recommends libnss3-tools libatk1.0-0 libatk-bridge2.0-0 libdrm-dev libxkbcommon-dev libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm-dev libasound2 libcups2 libpango-1.0-0 libcairo2

Jeżeli twój system znajduje się na serwerze opartym o dystrybucję Linux, możesz w prosty sposób pobrać Chrome/Chromium za pomocą skryptu bash.

Wykonaj poniższy skrypt, który pobierze najnowszą wersję Chromium/Chrome i umieści go gotowego do pracy na serwerze w lokalizacji ./latest

#! /bin/bash

cd $(dirname $0)

LASTCHANGE_URL="https://www.googleapis.com/download/storage/v1/b/chromium-browser-snapshots/o/Linux_x64%2FLAST_CHANGE?alt=media"

REVISION=$(curl -s -S $LASTCHANGE_URL)

echo "latest revision is $REVISION"

if [ -d $REVISION ] ; then
  echo "already have latest version"
  exit
fi

ZIP_URL="https://www.googleapis.com/download/storage/v1/b/chromium-browser-snapshots/o/Linux_x64%2F$REVISION%2Fchrome-linux.zip?alt=media"

ZIP_FILE="${REVISION}-chrome-linux.zip"

echo "fetching $ZIP_URL"

rm -rf $REVISION
mkdir $REVISION
pushd $REVISION
curl -# $ZIP_URL > $ZIP_FILE
echo "unzipping.."
unzip $ZIP_FILE
popd
rm -f ./latest
find chromium/* -type d -ctime +1 -exec rm -rf {} \;
ln -s $REVISION/chrome-linux/ ./latest
Rozwiązywanie problemów