https://github.com/astrotomic/php-open-graph
This package provides a fluent PHP OOP builder for Open Graph protocol.
https://github.com/astrotomic/php-open-graph
hacktoberfest open-graph open-graph-protocol php-open-graph treeware twitter
Last synced: 7 months ago
JSON representation
This package provides a fluent PHP OOP builder for Open Graph protocol.
- Host: GitHub
- URL: https://github.com/astrotomic/php-open-graph
- Owner: Astrotomic
- License: mit
- Created: 2017-02-22T15:38:09.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T20:28:51.000Z (over 1 year ago)
- Last Synced: 2024-10-29T21:06:02.421Z (about 1 year ago)
- Topics: hacktoberfest, open-graph, open-graph-protocol, php-open-graph, treeware, twitter
- Language: PHP
- Homepage: https://ogp.me/
- Size: 204 KB
- Stars: 59
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# PHP Open-Graph
[](https://packagist.org/packages/astrotomic/php-open-graph)
[](https://github.com/Astrotomic/php-open-graph/blob/master/LICENSE)
[](https://plant.treeware.earth/Astrotomic/php-open-graph)
[](https://www.larabelles.com/)
[](https://github.com/Astrotomic/php-open-graph/actions?query=workflow%3Apest)
[](https://github.com/Astrotomic/php-open-graph/actions?query=workflow%3Apint)
[](https://packagist.org/packages/astrotomic/php-open-graph)
This package provides a fluent PHP OOP builder for [Open Graph protocol](https://ogp.me) and [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards).
## Installation
You can install the package via composer:
```bash
composer require astrotomic/php-open-graph
```
## Usage
```php
use Astrotomic\OpenGraph\OpenGraph;
use Astrotomic\OpenGraph\StructuredProperties\Image;
echo OpenGraph::website('Example')
->url('https://example.com')
->image('https://example.com/image1.jpg')
->image(Image::make('https://example.com/image2.jpg')->width(600));
```
```html
```
### Types
#### Global
- `\Astrotomic\OpenGraph\Types\Article`
- `\Astrotomic\OpenGraph\Types\Book`
- `\Astrotomic\OpenGraph\Types\Profile`
- `\Astrotomic\OpenGraph\Types\Website`
#### Music
- `\Astrotomic\OpenGraph\Types\Music\Album`
- `\Astrotomic\OpenGraph\Types\Music\Playlist`
- `\Astrotomic\OpenGraph\Types\Music\RadioStation`
- `\Astrotomic\OpenGraph\Types\Music\Song`
#### Video
- `\Astrotomic\OpenGraph\Types\Video\Episode`
- `\Astrotomic\OpenGraph\Types\Video\Movie`
- `\Astrotomic\OpenGraph\Types\Video\Other`
- `\Astrotomic\OpenGraph\Types\Video\TvShow`
#### Twitter
- `\Astrotomic\OpenGraph\Types\Twitter\App`
- `\Astrotomic\OpenGraph\Types\Twitter\Player`
- `\Astrotomic\OpenGraph\Types\Twitter\SummaryLargeImage`
- `\Astrotomic\OpenGraph\Types\Twitter\Summary`
### Structured Properties
- `\Astrotomic\OpenGraph\StructuredProperties\Audio`
- `\Astrotomic\OpenGraph\StructuredProperties\Image`
- `\Astrotomic\OpenGraph\StructuredProperties\Video`
## Testing
```bash
composer test
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/Astrotomic/.github/blob/master/CONTRIBUTING.md) for details. You could also be interested in [CODE OF CONDUCT](https://github.com/Astrotomic/.github/blob/master/CODE_OF_CONDUCT.md).
### Security
If you discover any security related issues, please check [SECURITY](https://github.com/Astrotomic/.github/blob/master/SECURITY.md) for steps to report it.
## Credits
- [Tom Witkowski](https://github.com/Gummibeer)
- [Alex Vanderbist](https://github.com/AlexVanderbist)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
## Treeware
You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree.
It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.
You can buy trees at [offset.earth/treeware](https://plant.treeware.earth/Astrotomic/php-open-graph)
Read more about Treeware at [treeware.earth](https://treeware.earth)