{"id":13525237,"url":"https://github.com/joshp23/YOURLS-title-refetch","last_synced_at":"2025-04-01T04:31:31.712Z","repository":{"id":68878197,"uuid":"95192911","full_name":"joshp23/YOURLS-title-refetch","owner":"joshp23","description":"A simple plugin to refetch poorly defined titles in YOURLS","archived":false,"fork":false,"pushed_at":"2021-03-14T06:20:45.000Z","size":32,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-02T09:33:40.369Z","etag":null,"topics":["yourls","yourls-title-refetch"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joshp23.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-06-23T07:04:13.000Z","updated_at":"2023-03-28T12:44:40.000Z","dependencies_parsed_at":"2023-02-24T20:15:15.994Z","dependency_job_id":null,"html_url":"https://github.com/joshp23/YOURLS-title-refetch","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshp23%2FYOURLS-title-refetch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshp23%2FYOURLS-title-refetch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshp23%2FYOURLS-title-refetch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshp23%2FYOURLS-title-refetch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joshp23","download_url":"https://codeload.github.com/joshp23/YOURLS-title-refetch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246586087,"owners_count":20801025,"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":["yourls","yourls-title-refetch"],"created_at":"2024-08-01T06:01:17.054Z","updated_at":"2025-04-01T04:31:31.456Z","avatar_url":"https://github.com/joshp23.png","language":"PHP","funding_links":[],"categories":["Plugins"],"sub_categories":["T"],"readme":"# YOURLS-title-refetch\nA simple plugin to refetch poorly defined titles in YOURLS\n\n### The Problem\nSometimes YOURLS does not fetch the title of a url that is being processed, this happens frequently when using the api with certain 3rd party applications (which need attention from their developers). When this occures YOURLS uses the url itself as the title in the databse, which is less than desireable.\n\nAlso, sometimes a website will update the title of an article or post. When displaying a [preview page](https://github.com/joshp23/YOURLS-Snapshot) it would be desireable to have the most up-to-date titles of pages on display.\n\n### The solution\nThis plugin adds a new `key-\u003evalue` pair to `action=shorturl`, and if it is present will check the title of the new link and attempt to repair it if it is malformed.\n\n### Installation\nExtract the `title-refetch` folder in this repo into the `YOURLS/user/plugins/` directory and enable it in the admin interface.\n\n### Usage\n1.  Send the `refetch=true` along with a typical API shorturl call. Ex:\n```\nhttps://eg.com/yourls-api.php?refetch=true\u0026action=shorturl\u0026url=https://some.really.long.url.com/it_never/ends/index.php\n```\n2.  This plugin also creates a new api action:\n-  `action=refetch` which will trigger a refetch check according to one of the following required conditions:\n   -  `target=title` which will check a single link and requires`shorturl=EX`. The short url can be a keyword or a full short url.\n   -  `target=title-force` skips the malformed url check and just looks for an updated title. Requires `shorturl=EX`.\n   -  `target=all` which will run a check on the entire database and requires a valid log in (eg. signature or user/pass)\n3.  There is an action button in the admin section to force-update single links at a a time.\n\tNote: This button is filtered by [AuthMgrPlus](https://github.com/joshp23/YOURLS-AuthMgrPlus) with the `EditURL` capability, if installed.\n\n#### The catch\nWhile this doesn't cause the developers of third party applications to give attetnion to their code, it does make integration more flexible and provides an immediate working solution on YOURLS's end, akin to the [api-concurrence-fix](https://bitbucket.org/laceous/yourls-concurrency-fix) plugin. \n\n#### Note:\nThis module was initially developed to assist with integration of the [Drupal: Shorten URLs](https://www.drupal.org/project/shorten) module. An issue regarding this can be found [here](https://www.drupal.org/node/2889342).\n\n### Tips\nDogecoin: DARhgg9q3HAWYZuN95DKnFonADrSWUimy3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshp23%2FYOURLS-title-refetch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoshp23%2FYOURLS-title-refetch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshp23%2FYOURLS-title-refetch/lists"}