{"id":13759967,"url":"https://github.com/alwaysblank/extrovert","last_synced_at":"2025-05-12T23:27:14.467Z","repository":{"id":56946570,"uuid":"199095759","full_name":"alwaysblank/extrovert","owner":"alwaysblank","description":"Simple social media sharing links.","archived":false,"fork":false,"pushed_at":"2020-07-29T18:14:25.000Z","size":45,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-20T19:37:57.391Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alwaysblank.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-27T00:22:25.000Z","updated_at":"2020-10-17T02:51:38.000Z","dependencies_parsed_at":"2022-08-21T07:20:54.884Z","dependency_job_id":null,"html_url":"https://github.com/alwaysblank/extrovert","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fextrovert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fextrovert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fextrovert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fextrovert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alwaysblank","download_url":"https://codeload.github.com/alwaysblank/extrovert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253839233,"owners_count":21972299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-08-03T13:01:01.625Z","updated_at":"2025-05-12T23:27:14.446Z","avatar_url":"https://github.com/alwaysblank.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# Extrovert\r\n\r\nQuickly generate simple social media share URLs.\r\n\r\n[![Build Status](https://travis-ci.org/alwaysblank/extrovert.svg?branch=master)](https://travis-ci.org/alwaysblank/extrovert)\r\n\r\n## Usage\r\n\r\nThis project only generates URLs (and, optionally, link elements to wrap them); it does *not* implement any kind of more involved sharing activity, and it never will. It is not attempting to be a social media clearinghouse with deep integration, interactivity, and share counts, so it will only ever support services that allow for sharing through the simple mechanism of a link.\r\n\r\n### URL\r\n\r\nTo use it, simply call the `url()` static method on the network you want, passing in any relevant arguments. For instance, to generate a link to share something on Facebook, you would do this:\r\n\r\n```php\r\nAlwaysBlank\\Extrovert\\Network\\Facebook::url('https://www.alwaysblank.org');\r\n```\r\n\r\nSome networks also support additional information, such as a name or description. You can pass these serially, or as part of an array. The following are all equivalent:\r\n\r\n```php\r\nAlwaysBlank\\Extrovert\\Network\\ExampleNetwork::url('https://www.alwaysblank.org', \"Extrovert Can Help\", \"A new tool to generate simple share URLs.\");\r\n\r\nAlwaysBlank\\Extrovert\\Network\\ExampleNetwork::url([\r\n  'https://www.alwaysblank.org', \r\n  \"Extrovert Can Help\", \r\n  \"A new tool to generate simple share URLs.\"\r\n]);\r\n\r\nAlwaysBlank\\Extrovert\\Network\\ExampleNetwork::url([\r\n  'uri' =\u003e 'https://www.alwaysblank.org', \r\n  'name' =\u003e \"Extrovert Can Help\", \r\n  'description' =\u003e \"A new tool to generate simple share URLs.\"\r\n]);\r\n```\r\n\r\nAll content is automatically URL-encoded—do **not** pass in already encoded strings.\r\n\r\n### Link\r\n\r\nYou can also generate a simple link element, with a few [safety features](https://www.jitbit.com/alexblog/256-targetblank---the-most-underestimated-vulnerability-ever/). The syntax is very similar to `url()`, but with `link()` you *must* pass your url arguments as an array.\r\n\r\n```php\r\nAlwaysBlank\\Extrovert\\Network\\ExampleNetwork::link(\r\n  ['https://www.alwaysblank.org', \"Extrovert Can Help\", \"A new tool to generate simple share URLs.\"],\r\n  'Share on Network',\r\n  ['class' =\u003e 'link']\r\n);\r\n```\r\n\r\n## Supported Networks\r\n\r\n- Facebook - Supports only the `url` argument.\r\n- LinkedIn - Supports the `url` argument.\r\n- Twitter - Supports the `url` and `name` arguments.\r\n- Pinterest - Supports the `url`, `description`, and `media` arguments, but beat in mind that they *must* be passed as a key array, and that you *must* pass both a `url` and `media` value--Pinterest won't understand it otherwise, and you'll get odd results.\r\n- Email - Supports the `url` and `name`, and `description` arguments, but behaves a little differently. It expects `description` to contain a `%s` that will be replaced with the `url`. It will also attempt to generate reasonable defaults for `name` and `description` (the subject and body of the email respectively) if none are provided.\r\n- Your Favorite! - Submit an [issue](https://github.com/alwaysblank/extrovert/issues/new) or, even better, a [pull request](https://github.com/alwaysblank/extrovert/pulls)! Please do keep in mind the limitations and intentions of the project, however.\r\n\r\n## Notes\r\n\r\nExtrovert is very type-sensitive, so make sure you pass it arguments that it will like: Otherwise it will very rudely start throwing exceptions.\r\n\r\nIf you pass arguments that are the correct type but are otherwise incorrect, it will very politely just return an empty string. \r\n\r\nMany of these services will pull information to populate rich links from the URL you are telling them to link to. For this reason, it is wise to make sure that the metadata (and/or OpenGraph data) on that URL is correctly implemented. It also means that they will throw errors if you try to link to unreachable URLS (i.e. `development-site.local`); \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwaysblank%2Fextrovert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falwaysblank%2Fextrovert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwaysblank%2Fextrovert/lists"}