The AI-powered preview system built from your website (no effort required).
This package is agnostic to any PHP framework.
Haven't registered your website yet? Go to Flyyer.io and create a project (e.g. website-com
).
This package supports PHP >= 7.1.
composer require flyyer/flyyer
In your website code (e.g. your landing or product/post view file), set the following:
$flyyer = new Flyyer(
// Your project slug
'website-com',
// The current path of your website
'/path/to/product', // in Laravel 6 you can use `Route::getCurrentRoute()->getName()`
);
// (Optional, Recommended) Default or main image for each page
$flyyer->default = "/static/image-1.png" # or https://your-site.com/static/image-1.png
// Check:
print($flyyer->href());
// > https://cdn.flyyer.io/v2/website-com/_/__v=1618281823&_def=/static/image-1.png/path/to/product
You'll get the best results like this:
<meta property="og:image" content="{{ $flyyer->href() }} ">
<meta name="twitter:image" content="{{ $flyyer->href() }} ">
<meta name="twitter:card" content="summary_large_image">
Go to your dashboard here and create a rule like the following:
Voilà!
Here you have a detailed full example for project website-com
and path /path/to/product
.
Advanced features include:
- Custom variables: additional information for your preview that is not present in your website. [Note: if you need customization you should take a look at Flyyer Render]
- Custom metadata: set custom width, height, resolution, and more (see example).
- Signed URLs.
$flyyer = new Flyyer(
// [Required] Your project slug, find it in your dashboard https://www.flyyer.io/dashboard/_/projects/_/integrate.
'website-com',
// [Recommended] The current path of your website (by default it's `/`).
'/path/to/product',
// [Optional] In case you want to provide information that is not present in your page set it here.
[
'title' => 'Product name',
'img' => 'https://flyyer.io/img/marketplace/flyyer-banner.png'
],
// [Optional] Custom metadata for rendering the image. ID is recommended so we provide you with better statistics.
[
'id' => 'jeans-123', // recommended for better stats
'v' => '12369420123', // specific handler version, by default it's a random number to circumvent platforms' cache,
'width' => 1200,
'height' => 600,
'resolution' => 0.9, // from 0.0 to 1.0
'agent' => 'whatsapp', // force dimensions for specific platform
]);
// Use this image in your <head/> tags (og:image & twitter:image)
print($flyyer->href());
// > https://cdn.flyyer.io/v2/website-com/_/__id=jeans-123&__v=1618281823&img=https://flyyer.io/img/marketplace/flyyer-banner.png&title=Product name/path/to/product
For signed URLs, just provide your secret (find it in Dashboard > Project > Advanced settings) and choose a strategy (HMAC
or JWT
).
$flyyer = new Flyyer(
'website-com',
'/path/to/product',
[],
[ 'id' => 'jeans-123' ],
'your-secret-key',
'JWT', // or 'HMAC'
);
$url = $flyyer->href();
// > https://cdn.flyyer.io/v2/website-com/jwt-eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXJhbXMiOnsiX19pZCI6ImplYW5zLTEyMyJ9LCJwYXRoIjoiXC9wYXRoXC90b1wvcHJvZHVjdCJ9.X8Vs5SGEA1-3M6bH-h24jhQnbwH95V_G0f-gPhTBTzE?__v=1618283086
As you probably realized, Flyyer uses the rules defined on your dashboard to decide how to handle every image based on path patterns. It analyses your website to obtain information and then render a content-rich image with no effort. Let's say "Flyyer delivers images based on the content of this route".
Flyyer Render instead requires you to explicitly declare template and variables for the images to render, giving you more control for customization. Let's say "FlyyerRender delivers an image using this template and these explicit variables".
$flyyer = new FlyyerRender("tenant", "deck", "template");
$flyyer->variables = [
"title" => "Hello world!"
];
// Use this image in your <head/> tags
$url = $flyyer->href();
// > https://cdn.flyyer.io/render/v2/tenant/deck/template.jpeg?__v=1596906866&title=Hello world!
Variables can be complex arrays and objects.
$flyyer->variables = [
"items" => [
["text" => "Oranges", "count" => 12],
["text" => "Apples", "count" => 14]
]
];
IMPORTANT: variables must be serializable.
To decode the URL for debugging purposes:
print(urldecode($url));
// > https://cdn.flyyer.io/render/v2/tenant/deck/template.jpeg?title=Hello world!&__v=123
Prepare the local environment:
composer install
Run PHPUnit with:
composer dump-autoload
composer test