{"id":28282893,"url":"https://github.com/th23x/th23-upload","last_synced_at":"2026-05-03T15:34:02.908Z","repository":{"id":293436749,"uuid":"978621400","full_name":"th23x/th23-upload","owner":"th23x","description":"Resize images on upload to maximum dimensions, saving space and bandwidth. Watermark images upon upload or manually via Media Library","archived":false,"fork":false,"pushed_at":"2025-06-05T13:43:17.000Z","size":703,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T06:36:12.857Z","etag":null,"topics":["plugin","upload","watermark","wordpress"],"latest_commit_sha":null,"homepage":"","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/th23x.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-06T09:11:47.000Z","updated_at":"2025-06-05T13:40:18.000Z","dependencies_parsed_at":"2025-05-15T10:39:27.587Z","dependency_job_id":null,"html_url":"https://github.com/th23x/th23-upload","commit_stats":null,"previous_names":["th23x/th23-upload"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/th23x/th23-upload","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th23x%2Fth23-upload","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th23x%2Fth23-upload/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th23x%2Fth23-upload/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th23x%2Fth23-upload/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/th23x","download_url":"https://codeload.github.com/th23x/th23-upload/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th23x%2Fth23-upload/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32575111,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["plugin","upload","watermark","wordpress"],"created_at":"2025-05-21T16:13:46.008Z","updated_at":"2026-05-03T15:34:02.900Z","avatar_url":"https://github.com/th23x.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg alt=\"th23 Upload\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/icon-horizontal.png?v=2.1.0\" width=\"200\"\u003e\n\nResize images on upload to maximum dimensions, saving space and bandwidth. Watermark images upon upload or manually via Media Library\n\n\n## 🚀 Introduction\n\nProvides easy admin access to **define maximum width and height** of uploaded images. Uploads exceeding these dimensions will be resized accordingly. Only the defined maximum size will be stored on the server. This way you will be able to **save space and bandwidth** and serve pages faster to your visitors due to the reduced image size.\n\n**Watermark your precious images**, keeping track of them in the internet. New uploads can automatically be marked or you can **add/remove watermarks** via the Media Library. Unmarked copies of images are kept inaccessible to the public in case you want to restore it.\n\n[![th23 Upload - Intro video](https://img.youtube.com/vi/umfS6tGseqI/0.jpg)](https://www.youtube.com/watch?v=umfS6tGseqI)\n\nAdditionally th23 Upload offers some further options:\n\n* Keep **original aspect ration** of uploaded images, preventing automatic cropping\n* Specify a **suffix for resized images** to be added to names, eg upload of too large image `test.jpg` will be stored as `test_resized.jpg`\n* Set **quality for resized images**, allowing to save further space and bandwidth\n* Select image sizes to watermark, eg to excluding thumbnails\n* **Mass-add/-remove watermarks** for already uploaded image attachments\n* Select **location of watermark** on the image and maximum width/height to cover\n* Supports **GD Library** and **ImageMagick (Imagick)**\n\n\u003e \u003cimg alt=\"\" title=\"Plugin settings (maximum image upload size)\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-1.jpg?v=2.1.0\" width=\"400\"\u003e\n\u003e \u003cimg alt=\"\" title=\"Media uploader\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-2.jpg?v=2.1.0\" width=\"400\"\u003e\n\u003e \u003cimg alt=\"\" title=\"Media library (add/remove watermarks)\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-3.jpg?v=2.1.0\" width=\"400\"\u003e\n\u003e \u003cimg alt=\"\" title=\"Watermarked image (bottom right corner)\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-4.jpg?v=2.1.0\" width=\"400\"\u003e\n\u003e \u003cimg alt=\"\" title=\"Watermark settings (part 1)\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-5.jpg?v=2.1.0\" width=\"400\"\u003e\n\u003e \u003cimg alt=\"\" title=\"Watermark settings (part 2)\" src=\"https://raw.githubusercontent.com/th23x/th23-upload/refs/heads/main/assets/screenshot-6.jpg?v=2.1.0\" width=\"400\"\u003e\n\n\n## ⚙️ Setup\n\nFor a manual installation upload extracted `th23-upload` folder to your `wp-content/plugins` directory.\n\nThe plugin is **configured via its settings page in the admin area**. Find all options under `Settings` -\u003e `th23 Upload`. The options come with a description of the setting and its behavior directly next to the respective settings field.\n\n\n## 🖐️ Usage\n\nThis plugin **works in the background**, even for Admins and Editors of your website.\n\nOnce configured all work upon upload of new images happens during the normal process - images are resized and watermarked as per your configuration before they are added in the post / page editor.\n\nSee intro videos about functionality and configuration for an overview: [Visit the th23 Upload video series on Youtube](https://www.youtube.com/playlist?list=PLnpYL-vo05g3JRAJiL0xG6Dqc0HxZ1DJL).\n\n\u003e [!NOTE]\n\u003e **Only handles JPG / JPEG images**, as PNG (transparency) and GIF (animation) could loose their features upon resizing.!\n\nFor manually adding / removing of watermarks visit the Media Library, where you find this function as part of an images row actions, when hovering.\n\n\n## ❓ FAQ\n\n### Q: **Video tutorial**: Explaining all plugin settings in the admin area ###\n\nA: [![th23 Upload - Resize options video](https://img.youtube.com/vi/Cll7btE7udE/0.jpg)](https://www.youtube.com/watch?v=Cll7btE7udE)\n\n[![th23 Upload - Watermark options video](https://img.youtube.com/vi/dHO0qUTx1QE/0.jpg)](https://www.youtube.com/watch?v=dHO0qUTx1QE)\n\n### Q: How does this plugin help compared to the **default scaling of uploads**? ###\n\nA: By default WordPress limits the upload of images to **max 2560 px width / height, without providing any admin options to adjust** this setting. This plugin allows you to disable this default and replace it with a setting accessible via the admin options.\n\nThis plugin additionally allows a **customized suffix for resized images**, compared to the unchangeable default `-scaled` suffix.\n\nAlso the plugin can prevent creation of additional intermediate sizes of all uploaded images, which due to their dimensions of 1536px and 2048px would be taking up much additional space on your webserver.\n\n### Q: What is the ideal **image to use as a watermark**? ###\n\nA: You should use a `PNG` image as watermark with transparent background. Try it out locally over various backgrounds/ images - light ones as well as darker ones.\n\nThe size depends largely on the size of your images to be marked. You can save a larger copy of the watermark PNG and limit the maximum space to cover via the plugin options. Make sure your watermark is still readable/ visible also when scaled down.\n\n### Q: Why can **only JPG / JPEG images** be watermarked? ###\n\nA: Simple answer: Most images used in the internet are in the `JPG` format. Watermarking such images should meet most users needs.\n\nTechnical answer: Other image formats can contain information and have special characteristics making their handling very tricky and error-prone. For example: `PNG` files can contain transparency levels, additionally they can be animated. Similar for `GIF` images.\n\nHonest answer: To limit complexity of the plugin ;-)\n\n\n## 🤝 Contributors\n\nFeel free to [raise issues](https://github.com/th23x/th23-upload/issues) or [contribute code](https://github.com/th23x/th23-upload/pulls) for improvements via GitHub.\n\n\n## ©️ License\n\nYou are free to use this code in your projects as per the `GNU General Public License v3.0`. References to this repository are of course very welcome in return for my work 😉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fth23x%2Fth23-upload","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fth23x%2Fth23-upload","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fth23x%2Fth23-upload/lists"}