1. class
  2. Rokka
  3. \
  4. Client
  5. \
  6. TemplateHelper

TemplateHelper

Since: 1.3.0

class TemplateHelper (View source)

This class provides lots of helper functionality usually used in templates.

It can also manage looking up hashes and uploading images to rokka, see the docs for details.

Methods

__construct(string $organization, string $apiKey, AbstractCallbacks $callbacks = null, string|null $publicRokkaDomain = null, string|null $rokkaApiHost = BaseClient::DEFAULT_API_BASE_URL)

No description

string|null
getHashMaybeUpload(AbstractLocalImage $image)

Returns the hash of an image.

string
getStackUrl(AbstractLocalImage|string|SplFileInfo $image, string $stack, string|null $format = 'jpg', string|null $seo = null, string|null $seoLanguage = 'de')

Gets the rokka URL for an image Uploads it, if we don't have a hash locally.

string
getResizeUrl(AbstractLocalImage|string|SplFileInfo $image, string|int $width, string|int|null $height = null, string $format = 'jpg', string|null $seo = null, string $seoLanguage = 'de')

Return the rokka URL for getting a resized image.

string
getResizeCropUrl(AbstractLocalImage|string|SplFileInfo $image, string|int $width, string|int $height, string $format = 'jpg', string|null $seo = null, string $seoLanguage = '')

Return the rokka URL for getting a resized and cropped image.

string
getOriginalSizeUrl(AbstractLocalImage|string|SplFileInfo $image, string $format = 'jpg', string|null $seo = null, string $seoLanguage = '')

Return the rokka URL for getting the image in it's original size.

static string
getSrcAttributes(string $url, array $sizes = ['2x'])

Returns a src and srcset attibrute (as one string) with the correct rokka render urls for responsive images.

static string
getBackgroundImageStyle(string $url, array $sizes = ['2x'])

Returns a background-image:url defintions (as one string) with the correct rokka render urls for responsive images.

string
getImagename(AbstractLocalImage $image = null)

Returns the filename of the image without extension.

string
generateRokkaUrl(string $hash, string|StackUri $stack, string|null $format = 'jpg', string|null $seo = null, string|null $seoLanguage = 'de')

Gets the rokka URL for an image hash and stack with optional seo filename in the URL.

Image
getRokkaClient()

Gets the rokka image client used by this class.

static string
slugify(string $text, string $language = 'de')

Create a URL-safe text from $text.

Details

at line 53
__construct(string $organization, string $apiKey, AbstractCallbacks $callbacks = null, string|null $publicRokkaDomain = null, string|null $rokkaApiHost = BaseClient::DEFAULT_API_BASE_URL)

Since: 1.3.0

No description

Parameters

string $organization

Organization name
string $apiKey

API key
AbstractCallbacks $callbacks

Optional callbacks for read and write of hashes
string|null $publicRokkaDomain

Optional public rokka URL, if different from the standard one (org.render.rokka.io)
string|null $rokkaApiHost

Optional base url

at line 96
string|null getHashMaybeUpload(AbstractLocalImage $image)

Since: 1.3.0

Returns the hash of an image.

If we don't have an image stored locally, it uploads it to rokka.

Parameters

AbstractLocalImage $image

Return Value

string|null

Exceptions

GuzzleException

at line 130
string getStackUrl(AbstractLocalImage|string|SplFileInfo $image, string $stack, string|null $format = 'jpg', string|null $seo = null, string|null $seoLanguage = 'de')

Since: 1.3.0

Gets the rokka URL for an image Uploads it, if we don't have a hash locally.

Parameters

AbstractLocalImage|string|SplFileInfo $image

The image
string $stack

The stack name
string|null $format

The image format of the image (jpg, png, webp, ...)
string|null $seo

if you want a different seo string than the default
string|null $seoLanguage

Optional language to be used for slugifying (eg. 'de' slugifies 'ö' to 'oe')

Return Value

string

Exceptions

GuzzleException

at line 168
string getResizeUrl(AbstractLocalImage|string|SplFileInfo $image, string|int $width, string|int|null $height = null, string $format = 'jpg', string|null $seo = null, string $seoLanguage = 'de')

Since: 1.3.0

Return the rokka URL for getting a resized image.

Parameters

AbstractLocalImage|string|SplFileInfo $image

The image to be resized
string|int $width

The width of the image
string|int|null $height

The height of the image
string $format

The image format of the image (jpg, png, webp, ...)
string|null $seo
string $seoLanguage

Return Value

string

Exceptions

GuzzleException

at line 197
string getResizeCropUrl(AbstractLocalImage|string|SplFileInfo $image, string|int $width, string|int $height, string $format = 'jpg', string|null $seo = null, string $seoLanguage = '')

Since: 1.3.0

Return the rokka URL for getting a resized and cropped image.

Parameters

AbstractLocalImage|string|SplFileInfo $image

The image to be resized
string|int $width

The width of the image
string|int $height

The height of the image
string $format

The image format of the image (jpg, png, webp, ...)
string|null $seo
string $seoLanguage

Return Value

string

Exceptions

GuzzleException

at line 220
string getOriginalSizeUrl(AbstractLocalImage|string|SplFileInfo $image, string $format = 'jpg', string|null $seo = null, string $seoLanguage = '')

Since: 1.3.0

Return the rokka URL for getting the image in it's original size.

Parameters

AbstractLocalImage|string|SplFileInfo $image

The image to be resized
string $format

The image format of the image (jpg, png, webp, ...)
string|null $seo
string $seoLanguage

Return Value

string

Exceptions

GuzzleException

at line 241
static string getSrcAttributes(string $url, array $sizes = ['2x'])

Since: 1.3.0

Returns a src and srcset attibrute (as one string) with the correct rokka render urls for responsive images.

To be used directly in your HTML templates.

Parameters

string $url

The render URL of the "non-retina" image
array $sizes

For which sizes srcset links should be generated, works with 'x' or 'w' style

Return Value

string

at line 279
static string getBackgroundImageStyle(string $url, array $sizes = ['2x'])

Since: 1.3.0

Returns a background-image:url defintions (as one string) with the correct rokka render urls for responsive images.

To be used directly in your CSS templates or HTML tags.

Parameters

string $url

The render URL of the "non-retina" image
array $sizes

For which sizes srcset links should be generated, works with 'x' or 'w' style

Return Value

string

at line 310
string getImagename(AbstractLocalImage $image = null)

Since: 1.3.0

Returns the filename of the image without extension.

Parameters

AbstractLocalImage $image

Return Value

string

at line 334
string generateRokkaUrl(string $hash, string|StackUri $stack, string|null $format = 'jpg', string|null $seo = null, string|null $seoLanguage = 'de')

Since: 1.3.0

Gets the rokka URL for an image hash and stack with optional seo filename in the URL.

Doesn't upload it, if we don't have a local hash for it. Use getStackUrl for that.

Parameters

string $hash

The rokka hash
string|StackUri $stack

The stack name or a StackUrl object
string|null $format

The image format of the image (jpg, png, webp, ...)
string|null $seo

If you want to use a seo string in the URL
string|null $seoLanguage

Optional language to be used for slugifying (eg. 'de' slugifies 'ö' to 'oe')

Return Value

string

See also

TemplateHelper::getStackUrl

at line 363
Image getRokkaClient()

Since: 1.3.0

Gets the rokka image client used by this class.

Return Value

Image

at line 382
static string slugify(string $text, string $language = 'de')

Since: 1.3.0

Create a URL-safe text from $text.

Parameters

string $text

Text to slugify
string $language

Optional language to be used for slugifying (eg. 'de' slugifies 'ö' to 'oe')

Return Value

string

A string that should work in urls. Empty string is only allowed if $emptyText is ''