{"id":36373952,"url":"https://github.com/cronixweb/bigcommerce-oauth-laravel","last_synced_at":"2026-01-11T14:04:06.625Z","repository":{"id":179255887,"uuid":"651760562","full_name":"cronixweb/bigcommerce-oauth-laravel","owner":"cronixweb","description":"BigCommerce Single Click App Authentication made easy","archived":false,"fork":false,"pushed_at":"2025-08-19T00:34:03.000Z","size":47,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-23T08:53:23.522Z","etag":null,"topics":["authentication","bigcommerce","laravel","laravel-package"],"latest_commit_sha":null,"homepage":"https://developer.cronixweb.com/docs/bigcommerce/bigcommerce-oauth-laravel","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/cronixweb.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-10T02:43:04.000Z","updated_at":"2025-08-19T03:14:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"38ec31d8-f43c-4889-bb8b-5247cddcdd21","html_url":"https://github.com/cronixweb/bigcommerce-oauth-laravel","commit_stats":null,"previous_names":["cronixweb/bigcommerce-oauth-laravel"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/cronixweb/bigcommerce-oauth-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cronixweb%2Fbigcommerce-oauth-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cronixweb%2Fbigcommerce-oauth-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cronixweb%2Fbigcommerce-oauth-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cronixweb%2Fbigcommerce-oauth-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cronixweb","download_url":"https://codeload.github.com/cronixweb/bigcommerce-oauth-laravel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cronixweb%2Fbigcommerce-oauth-laravel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28306985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T11:18:18.743Z","status":"ssl_error","status_checked_at":"2026-01-11T11:07:56.842Z","response_time":60,"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":["authentication","bigcommerce","laravel","laravel-package"],"created_at":"2026-01-11T14:04:05.994Z","updated_at":"2026-01-11T14:04:06.619Z","avatar_url":"https://github.com/cronixweb.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BigCommerce OAuth for Laravel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/cronix-logo.svg\" alt=\"Cronix\" style=\"height: 60px !important;\" /\u003e\n  \u003cspan\u003e\u0026nbsp;\u0026nbsp;×\u0026nbsp;\u0026nbsp;\u003c/span\u003e\n  \u003cimg src=\"assets/bigcommerce-logo.svg\" alt=\"BigCommerce\" style=\"height: 72px !important;\" /\u003e\n\u003c/p\u003e\n\nA lightweight, drop‑in Laravel package that implements the full BigCommerce OAuth flow (install, load, uninstall, remove user). Designed to work in small apps and large, complex, multi‑tenant systems alike.\n\nOfficial docs: https://developer.cronixweb.com/docs/bigcommerce/bigcommerce-oauth-laravel\n\n## Features\n- Install, Load, Uninstall, Remove User routes ready to use.\n- Persists store access tokens and user–store relationships.\n- Simple Facade API for callbacks, session store selection, and token access.\n- Laravel 10 and 11 compatible; PHP 8.2+.\n\n## Requirements\n- PHP `^8.2`\n- Laravel `^10` or `^11`\n\n## Installation\n```bash\ncomposer require cronixweb/bigcommerce-oauth-laravel\n```\nThe service provider is auto‑discovered.\n\nPublish config, migrations, and views into your app, then run migrations:\n```bash\nphp artisan vendor:publish --provider=\"CronixWeb\\\\BigCommerceAuth\\\\BigAuthServiceProvider\" --tag=config,migrations,views\nphp artisan migrate\n```\n\n## Configure\nSet the following environment variables in your Laravel app:\n```\nBC_CLIENT_ID=your_client_id\nBC_SECRET=your_client_secret\nBC_REDIRECT_PATH=/       # where to redirect after successful install/load\n```\nYou can also override defaults in `config/bigcommerce-auth.php` (tables, controllers, views).\n\n## Routes\nThis package ships a route file with the following endpoints (prefixed by `auth`):\n- `GET /auth/install` → handles OAuth installation\n- `GET /auth/load` → verifies signed payload and logs user in\n- `GET /auth/uninstall` → uninstall callback\n- `GET /auth/remove_user` → remove user callback\n\nRegister the package routes once in your application (e.g., in `routes/web.php` or a service provider):\n```php\nuse CronixWeb\\BigCommerceAuth\\BigAuthRoutes;\n\nBigAuthRoutes::register();\n```\n\nIn the BigCommerce Developer Portal, set your app callback URLs to your app domain:\n- Auth Callback URL: `https://your-app.com/auth/install`\n- Load Callback URL: `https://your-app.com/auth/load`\n- Uninstall Callback URL: `https://your-app.com/auth/uninstall`\n- Remove User Callback URL: `https://your-app.com/auth/remove_user`\n\nFor an end‑to‑end setup guide and screenshots, see the official documentation: https://developer.cronixweb.com/docs/bigcommerce/bigcommerce-oauth-laravel\n\n## Database\nPublished migrations create:\n- `stores` (id, hash, access_token, timestamps, softDeletes)\n- `store_has_users` (store_id, user_id, timestamps, composite PK)\n- Updates `users` to allow nullable `name` and `password` (for SSO‑style accounts)\n\nThe default Eloquent model is `CronixWeb\\BigCommerceAuth\\Models\\Store` and can be swapped via config.\n\n## Usage\nHook into lifecycle callbacks and access tokens via the Facade:\n```php\nuse CronixWeb\\BigCommerceAuth\\Facades\\BigCommerceAuth as BC;\n\n// In a service provider's boot():\nBC::setInstallCallback(function ($user, $store) {\n    // e.g., provision tenant resources, set roles\n});\n\nBC::setLoadCallback(function ($user, $store) {\n    // e.g., initialize per-request context, analytics\n});\n\nBC::setUninstallStoreCallBack(function ($payload) {\n    // e.g., revoke tokens, archive data for $payload['store_hash']\n});\n\nBC::setRemoveStoreUserCallBack(function ($payload) {\n    // e.g., detach user from store\n});\n\n// Later in your app code:\n// Ensure the store hash is set (done during load/install), then get the token\n$token = BC::getStoreAccessToken();\n$store = BC::store(); // current store Eloquent record\n```\n\nAdvanced: You can override how the access token is resolved or how the current store is found using `setGetStoreAccessTokenCallback()` and `setFindStoreFromSessionCallBack()`.\n\n## Security Notes\n- Keep `BC_CLIENT_ID` and `BC_SECRET` in env; never commit secrets.\n- Production requests verify TLS by default; development uses `Http::withoutVerifying()`.\n- Treat `stores.access_token` as sensitive; avoid logging.\n\n## Logos\nPlace logo assets at:\n- `assets/cronix-logo.png`\n- `assets/bigcommerce-logo.png`\n\nThe README header references these paths to showcase the partnership branding.\n\n## Contributing\nWe follow Conventional Commits (e.g., `feat:`, `fix:`, `refactor:`). Please include a clear description, note schema/config changes, and add tests where possible. Open issues or PRs are welcome.\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcronixweb%2Fbigcommerce-oauth-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcronixweb%2Fbigcommerce-oauth-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcronixweb%2Fbigcommerce-oauth-laravel/lists"}