nopCommerce Dokumentace

Integrace Cloudflare Images

Přehled

Od verze 4.90 byla správa náhledů (thumbnails) přepracována pro větší flexibilitu. Bylo zavedeno nové rozhraní IThumbService, které obsluhuje všechny operace související s náhledy, jež dříve spravovala služba 'IPictureService`.

Do IThumbService byly přesunuty následující metody:

  • GetThumbLocalPathAsync
  • GeneratedThumbExistsAsync
  • SaveThumbAsync
  • GetThumbLocalPathByFileNameAsync
  • GetThumbUrlAsync
  • DeletePictureThumbsAsync

V rámci této změny byla logika ukládání náhledů oddělena od jádra aplikace do samostatných pluginů. Stávající funkcionalita Azure Blob Storage je nyní samostatným pluginem. Byl vyvinut nový plugin pro integraci Cloudflare Images jako řešení pro ukládání náhledů.

Poznámka

Ve výchozím stavu jsou oba pluginy, Azure Blob i Cloudflare Images (Misc.AzureBlob a Misc.CloudflareImages), uvedeny ve vlastnosti InstallationConfig.DisabledPlugins. Tím je zajištěno, že ani jeden z pluginů nebude nainstalován při nové instalaci, a majitelé obchodů si tak mohou zvolit a nainstalovat řešení úložiště, které nejlépe vyhovuje jejich potřebám.

Konfigurace Azure Blob Storage

K ukládání blob dat můžeme použít Azure Blob Storage. nopCommerce již má tuto funkci integrovanou, stačí jen správně nastavit následující informace. Hodnoty těchto nastavení lze získat z Azure při vytváření účtu úložiště.

Obrázek

  • ConnectionString Toto nastavení očekává řetězcovou hodnotu. Zde je třeba přidat připojovací řetězec AzureBlobStorage.
  • ContainerName Hodnota tohoto nastavení je rovněž typu řetězec. V tomto nastavení nastavujeme název kontejneru pro Azure BLOB storage.
  • EndPoint Toto nastavení rovněž očekává řetězcovou hodnotu. Zde je třeba nastavit endpoint pro Azure BLOB storage.
  • AppendContainerName Toto nastavení očekává logickou hodnotu (boolean). Nastavte hodnotu na true nebo false podle toho, zda se má při sestavování URL k EndPoint připojit název kontejneru.

Konfigurace Cloudflare Images

Nastavení pluginu jsou jednoduchá a kromě hlavního přepínače povolení/zakázání se skládají ze čtyř polí.

Obrázek

Zásadním polem je Delivery URL. Musí být nakonfigurováno v následujícím specifickém formátu:

https://imagedelivery.net/[account_hash]/<image_id>/<variant_name>

Tato URL slouží jako šablona. Plugin do ní dynamicky vloží požadované image_id a variant_name, čímž vygeneruje výsledné URL náhledů zobrazovaných na webu.

Použití

Po konfiguraci a povolení pracuje plugin automaticky na pozadí, podobně jako integrace Azure Blob storage. Bezproblémově zajišťuje:

  • Nahrávání nových náhledů do služby Cloudflare Images.
  • Nahrazení lokálních URL náhledů odpovídajícími URL Cloudflare Images na všech veřejných stránkách.
Přispěvatelé: DmitriyKulagin
Upravit na GitHubu