Download the PHP package saasykit/laravel-open-graphy without Composer
On this page you can find all versions of the php package saasykit/laravel-open-graphy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download saasykit/laravel-open-graphy
More information about saasykit/laravel-open-graphy
Files in saasykit/laravel-open-graphy
Package laravel-open-graphy
Short Description An awesome open graph image (social cards) generator package for Laravel.
License MIT
Homepage https://github.com/saasykit/laravel-open-graphy
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-open-graphy
Open Graphy is an awesome open graph image (social / twitter / X cards) generator package for your Laravel applications.
With Open Graphy, you can generate social cards for your website dynamically. You can use the default template or create your own template.
Features:
- Easily generate open graph images for your website.
- Add title, an image and your logo to the open graph image.
- Add a screenshot of the page inside the open graph image to show the preview of the page.
- 5 different templates to choose from.
- Customize the colors and styles of the templates.
- Cache the generated images.
- Create your own template if you want.
Examples: 👇
Requirements
- PHP 8.1+
Installation
- You need to install the
chromiumorchromebrowser on your server as it's being used by Open Graphy to render images.
Ubuntu/Debian:
Note for Ubuntu ARM systems:
Sometimes Ubuntu systems that are based on ARM might have problems with snap packages (like chromium), and because of that chromium might not work via the web server. In this case you can try setting the generate_with_command option to true in the config file. This will generate the open graph image with a command instead from the controller.
MacOS:
Laravel Sail using MacOS (Apple Silicon): I found the following steps to work for me on my M1 Macbook Pro:
- Once done, You can install the package via composer:
You can publish the config file with:
This is the contents of the published config file:
Configuration options:
chrome_binary: Based on the browser you installed, you can set thechrome_binaryto eitherchromeorchromium. You can also leave it set as null to allow auto discovery of the binary. You can also provide the full path to the binary.open_graph_image: The settings for the final generated open graph image.image: The path (relative to the public directory) or URL to the image to be added to the open graph image.fallback_open_graph_image: The path (relative to the public directory) or URL to the image to be used as a fallback if the open graph image cannot be generated.logo: The settings for the logo to be added to the open graph image.render_timeout: The maximum time to wait for the screenshot to render before failing.screenshot: The settings for the screenshot to be added to the open graph image.storage: The cache location to use to store the generated images.template: The template to use for the open graph image.template_settings: The settings for the templates included in the package.
The configs above allow you to edit the colors and styling of the provided templates, but if you prefer to go god mode and edit styles or introduce new templates, you can publish the views using the following command:
See below for Creating a custom template for more details.
Usage
All what you need to do is to call the following component in your <head> tag in your blade file:
This component accepts the following parameters:
title: The title to be displayed on the open graph image. (required)image: The image (path from public directory or a URL) to be displayed on the open graph image. (optional)template: The template to use for the open graph image. You can choose frombackground,stripes,sunny,verticals,nodes(optional).screenshot: Set totrueto add a screenshot of the page to the open graph image, will override thescreenshot.enabledsetting in the config file. (optional) See Website screenshot for more details.logo: Set totrueto add a logo to the open graph image, will override thelogo.enabledsetting in the config file. (optional)
Calling the x-open-graphy::links component will generate the following meta tags in your HTML:
Figuring out your best design:
Open Graphy comes with a testing route (only available for local environment) that you can use to test the different templates and settings. You can access the route by visiting /open-graphy/test in your browser.
It accepts the following query parameters:
title: The title to be displayed on the open graph image.image: The image to be displayed on the open graph image (optional).template: The template to use for the open graph image. You can choose frombackground,stripes,sunny,verticals,nodes(optional).
You would typically need to edit the settings in the config file to change the colors and styles of the templates, and keep testing until you find the best design for your website.
Website Screenshots:
You can also add a screenshot of the page to the open graph image. This is useful if you want to show a preview of the page in the open graph image. To enable this feature, set the screenshot.enabled to true in the config file.
Example:
Important 1: this feature works only if the page is accessible from the internet where the package is installed. What happens is that the package will open the page in a headless browser, take a screenshot of the page and add it to the open graph image. This will NOT work on a Laravel sail installation unless do you do some magic.
Important 2: most of the time screenshotting works fine, but sometimes longer pages or ones that have more heavy effects will timout. You can increase the render_timeout in the config file to allow more time for the screenshot to render, but Open Graphy will fail gracefully if the screenshot could not be taken, and will still generate the open graph image without the screenshot.
Clearing the cache:
You can clear the cache of the generated images using the following command:
Creating a custom template:
To create a custom template, you need to publish the views (if you haven't already) using the following command:
Now you can create a new blade file in the resources/views/vendor/open-graphy/templates directory. The file should contain the HTML and CSS for the template. You can get some inspiration from the existing templates in the package.
Once you have created the template, you can set the template key in the config file to the name of the template file (without the .blade.php extension). For example, if you created a file called custom.blade.php, you would set the template key to custom.
You can use the following pattern library if you're looking for cool ones: https://www.svgbackgrounds.com/set/free-svg-backgrounds-and-patterns/
Wanna build a Laravel SaaS application quickly?
If you want to build a SaaS app quickly, support us by checking out SaaSykit. It's a SaaS starter kit (boilerplate) that comes packed with all components required to run a modern SaaS software.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-open-graphy with dependencies
chrome-php/chrome Version ^1.11
illuminate/contracts Version ^10.0||^11.0
spatie/laravel-package-tools Version ^1.16
ext-fileinfo Version *