{"id":16882748,"url":"https://github.com/lildude/phpsmug","last_synced_at":"2025-05-12T04:21:49.684Z","repository":{"id":2655980,"uuid":"2025144","full_name":"lildude/phpSmug","owner":"lildude","description":":camera: phpSmug is a simple object orientated wrapper for the new SmugMug API v2, written in PHP.","archived":false,"fork":false,"pushed_at":"2025-03-21T23:48:17.000Z","size":1309,"stargazers_count":43,"open_issues_count":1,"forks_count":16,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-19T08:16:15.749Z","etag":null,"topics":["composer","maintained","php","php-library","smugmug-api"],"latest_commit_sha":null,"homepage":"https://lildude.github.io/phpSmug","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lildude.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":"lildude"}},"created_at":"2011-07-10T09:20:18.000Z","updated_at":"2025-04-18T19:07:26.000Z","dependencies_parsed_at":"2024-10-13T16:08:38.516Z","dependency_job_id":"13447e22-4862-4aee-8fd4-d1cdd9b3fe7b","html_url":"https://github.com/lildude/phpSmug","commit_stats":{"total_commits":503,"total_committers":8,"mean_commits":62.875,"dds":0.0437375745526839,"last_synced_commit":"7bfb5b5f0c4e4cae219f327ed0af6c824487cffb"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lildude%2FphpSmug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lildude%2FphpSmug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lildude%2FphpSmug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lildude%2FphpSmug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lildude","download_url":"https://codeload.github.com/lildude/phpSmug/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253673321,"owners_count":21945584,"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":["composer","maintained","php","php-library","smugmug-api"],"created_at":"2024-10-13T16:08:35.428Z","updated_at":"2025-05-12T04:21:49.660Z","avatar_url":"https://github.com/lildude.png","language":"PHP","readme":"\n# phpSmug\n\n[![Coverage Status](https://coveralls.io/repos/lildude/phpSmug/badge.svg?branch=main\u0026service=github)](https://coveralls.io/github/lildude/phpSmug?branch=main) ![Test Status](https://github.com/lildude/phpSmug/workflows/Run%20Tests/badge.svg)\n\nphpSmug is a simple object orientated wrapper for the new SmugMug API v2, written in PHP.\n\nThe intention of this class is to allow PHP application developers quick and easy interaction with the SmugMug API, without having to worry about the finer details of the API.\n\nNot already a SmugMug user? Here, have a **$5 discount** off your first year on me by [registering](https://secure.smugmug.com/signup.mg?Coupon=2ZxFXMC19qOxU) using this code:\n\n**[2ZxFXMC19qOxU](https://secure.smugmug.com/signup.mg?Coupon=2ZxFXMC19qOxU)**\n\nThe development of phpSmug takes place in my free time. If you find phpSmug useful and found it has saved you a lot of time, consider sponsoring this project.\n\n---\n\n**Note: Due to significant changes in the SmugMug API, phpSmug 4.0.0 and later is not backwardly compatible with the SmugMug API v1.x.x releases.**\n\n## Requirements\n\n* PHP \u003e= 8.1.0,\n* [Guzzle 7](https://github.com/guzzle/guzzle) library and the [Guzzle OAuth1 Subscriber](https://github.com/guzzle/oauth-subscriber),\n* (optional) [PHPUnit](https://phpunit.de/) to run tests.\n\n## Installation\n\nThe recommended method of installing phpSmug is using [Composer](http://getcomposer.org). If you have Composer installed, you can install phpSmug and all its dependencies from within your project directory:\n\n```bash\ncomposer require lildude/phpsmug\n```\n\nAlternatively, you can add the following to your project's `composer.json`:\n\n```json\n{\n    \"require\": {\n        \"lildude/phpsmug\": \"^4.0\"\n    }\n}\n```\n\n.. and then run `composer update` from within your project directory.\n\nIf you don't have Composer installed, you can download it using:\n\n```bash\ncurl -s http://getcomposer.org/installer | php\n```\n\n## Basic Usage of the phpSmug Client\n\n`phpSmug` follows the PSR-1, PSR-2 and PSR-4 conventions, which means you can easily use Composer's [autoloading](https://getcomposer.org/doc/01-basic-usage.md#autoloading) to integrate `phpSmug` into your projects.\n\n```php\n\u003c?php\n\n// This file is generated by Composer\nrequire_once 'vendor/autoload.php';\n\n// Optional, but definitely nice to have, options\n$options = [\n    'AppName'   =\u003e 'My Cool App/1.0 (http://app.com)',\n];\n$client = new phpSmug\\Client(\"[YOUR_API_KEY]\", $options));\n$albums = $client-\u003eget('user/[your_username]!albums');\n```\n\nFrom the `$client` object, you can access to all the SmugMug 2.0 API methods.\n\n## Documentation\n\nSee the [`docs` directory](docs/) or \u003chttps://lildude.github.io/phpSmug/\u003e for more detailed documentation.\n\n## Examples\n\nphpSmug comes with 3 examples to help get you on your way. All 3 examples perform the same thing, just using differing authentication methods. They all show thumbnails of the first album found for the respective authentication methods:\n\n- `example.php` illustrates anonymous, unauthenticated access.\n- `example-oauth.php` illustrates an OAuth login.\n- `example-external-links.php` illustrates displaying private images.\n\n## Getting Help\n\nThe best way to get help with implementing phpSmug into your projects is to open an [issue](https://github.com/lildude/phpSmug/issues).  This allows you to easily search for other issues where others may have asked to the same questions or hit the same problems and if they haven't, your issue will add to the resources available to others at a later date.\n\nPlease don't be shy. If you've got a question, problem or are just curious about something, there's a very good chance someone else is too, so go ahead and open an issue and ask.\n\n## Contributing\n\nFound a bug or want to make phpSmug even better? Please feel free to open a pull request with your changes, but be sure to check out the [CONTRIBUTING.md](CONTRIBUTING.md) first for some tips and guidelines. No pull request is too small.\n\n## Changes\n\nAll notable changes to this project are documented in [CHANGELOG.md](CHANGELOG.md).\n\n## License\n\nphpSmug is licensed under the MIT License - see the LICENSE file for details\n","funding_links":["https://github.com/sponsors/lildude"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flildude%2Fphpsmug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flildude%2Fphpsmug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flildude%2Fphpsmug/lists"}