{"id":30013110,"url":"https://github.com/brainstreaminfo/oro-nylas-email","last_synced_at":"2025-08-05T15:46:04.604Z","repository":{"id":306567714,"uuid":"1026165956","full_name":"brainstreaminfo/oro-nylas-email","owner":"brainstreaminfo","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-05T05:11:05.000Z","size":130,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-05T07:09:35.741Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/brainstreaminfo.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,"zenodo":null}},"created_at":"2025-07-25T12:21:30.000Z","updated_at":"2025-07-26T08:57:48.000Z","dependencies_parsed_at":"2025-07-26T14:45:57.560Z","dependency_job_id":"54150321-7448-48b9-94ad-95166a9b8b8f","html_url":"https://github.com/brainstreaminfo/oro-nylas-email","commit_stats":null,"previous_names":["brainstreaminfo/oro-nylas-email"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brainstreaminfo/oro-nylas-email","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainstreaminfo%2Foro-nylas-email","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainstreaminfo%2Foro-nylas-email/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainstreaminfo%2Foro-nylas-email/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainstreaminfo%2Foro-nylas-email/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brainstreaminfo","download_url":"https://codeload.github.com/brainstreaminfo/oro-nylas-email/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainstreaminfo%2Foro-nylas-email/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268926282,"owners_count":24330223,"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","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-08-05T15:46:03.860Z","updated_at":"2025-08-05T15:46:04.595Z","avatar_url":"https://github.com/brainstreaminfo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BrainStream Nylas Bundle\n\n## Overview\n\nThe BrainStream Nylas Bundle integrates Nylas email services with OroCRM for seamless email account connection and folder synchronization. This bundle extends OroCRM's email functionality, allowing users to manage Nylas-connected email folders and customize sync preferences via an intuitive interface.\n\n## Features\n\n- **OAuth Integration**: Connect Nylas email accounts to OroCRM using secure OAuth authentication\n- **Folder Synchronization**: Synchronize email folders including Inbox, Sent, and Custom Labels\n- **Flexible UI**: Enable/disable folder synchronization with an intuitive checkbox-based interface\n- **Enterprise Compatible**: Full compatibility with OroCRM 6.1 and later versions\n\n## Requirements\n\n- **OroCRM**: Version 6.1.0 or higher\n- **PHP**: Version 8.1 or higher\n- **Nylas API Credentials**: Client ID and Client Secret from [Nylas Dashboard](https://dashboard.nylas.com)\n\n## Installation\n\n### 1. Install via Composer\n\nAdd the bundle to your OroCRM project:\n\n```bash\ncomposer require brainstream/nylas-bundle:dev-main\n```\n\n### 2. Enable the Bundle\n\nRegister the bundle in your `config/bundles.php` file:\n\n```php\nreturn [\n    // Other bundles...\n    BrainStream\\Bundle\\NylasBundle\\BrainStreamNylasBundle::class =\u003e ['all' =\u003e true],\n];\n```\n\n### 3. Update Database Schema\n\nRun the following command to apply migrations:\n\n```bash\nphp bin/console oro:migration:load --force\n```\n\n\u003e **Note**: Use `--force` only in development or initial setup. In production, coordinate with your deployment process to avoid data issues.\n\n### 4. Clear and Warm Up Cache\n\nClear the cache to ensure the bundle is fully loaded:\n\n```bash\nphp bin/console cache:clear --env=prod\nphp bin/console cache:warmup --env=prod\n```\n\n### 5. Configure Nylas Credentials\n\n1. Log in to the [Nylas Dashboard](https://dashboard.nylas.com) to obtain your Client ID and Client Secret\n2. In OroCRM, navigate to **System \u003e Configuration \u003e Integrations \u003e Nylas Settings**\n3. Enter the Client ID and Client Secret, then save\n\n### 6. Access the Feature\n\n1. Go to Nylas Email Sync from top right menu in the OroCRM dashboard\n2. Click \"Connect New Account\" to authenticate with Nylas\n3. Select an email account from the dropdown\n4. Choose folders to sync and click \"Save Sync Preferences\"\n\n### Managing Preferences\n\n- Reload the page to see updated sync statuses reflected by checked checkboxes\n- Adjust settings as needed and save again to modify your sync preferences\n\n## Configuration\n\n### Set Default Account\n\nThe first connected account is automatically set as default. Use the \"Mark as Default\" action to change the default account.\n\n### Set Active/Deactive status for Account\n\nThe account connected by default will be active. Use the \"Active/Deactive\" action to toogle the account status.\n\n### Enable Multiple Accounts\n\nEnable multiple email support in user settings to connect and manage additional email accounts.\n\n## Troubleshooting\n\n### Sync Not Saving\n\nIf synchronization preferences aren't saving:\n\n1. Check `var/logs/dev.log` for error messages\n2. Verify Nylas credentials are correct\n3. Ensure network access to Nylas API\n4. Review OroCRM configuration settings\n\n### Debug Logging\n\nEnable detailed debug logging by configuring `config/packages/dev/monolog.yaml` for comprehensive error traces.\n\n## Changelog\n\n### Version 1.0.0 (Initial Release - June 2025)\n\n- Added Nylas email integration with OAuth authentication\n- Implemented folder synchronization UI with folderUid support\n- Initial compatibility with OroCRM 6.1\n\n## License\n\nThis bundle is released under the **MIT License**. See the [LICENSE](LICENSE) file for complete details.\n\n## Support\n\nFor issues, questions, or feature requests:\n\n- **GitHub Issues**: Open an issue on the GitHub repository\n- **Email Support**: Contact [info@brainstream.tech.](mailto:info@brainstream.tech.)\n\n## Acknowledgments\n\nBuilt by **BrainStream**, leveraging the powerful OroCRM and Nylas ecosystems to deliver seamless email integration solutions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainstreaminfo%2Foro-nylas-email","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrainstreaminfo%2Foro-nylas-email","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainstreaminfo%2Foro-nylas-email/lists"}