{"id":13807386,"url":"https://github.com/SkyZeroZx/ngx-facebook-messenger","last_synced_at":"2025-05-14T00:31:22.571Z","repository":{"id":193803601,"uuid":"689407207","full_name":"SkyZeroZx/ngx-facebook-messenger","owner":"SkyZeroZx","description":"Ngx Facebook Messenger offers a lightweight alternative, optimizing user experiences by significantly reducing the initial load size, ensuring smoother page performance, and enhancing overall website efficiency","archived":false,"fork":false,"pushed_at":"2024-07-14T05:25:01.000Z","size":1028,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-24T11:02:42.091Z","etag":null,"topics":["angular","angular-facebook","angular-messenger","facebook-messenger","facebook-sdk","messenger-customer-chat","messenger-customer-plugin","ngx-facebook-messenger"],"latest_commit_sha":null,"homepage":"https://skyzerozx.github.io/ngx-facebook-messenger/","language":"TypeScript","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/SkyZeroZx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2023-09-09T17:51:27.000Z","updated_at":"2024-08-30T03:28:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"35c3b47d-fc26-4c84-bbf8-9da80d69e906","html_url":"https://github.com/SkyZeroZx/ngx-facebook-messenger","commit_stats":null,"previous_names":["skyzerozx/ngx-facebook-messenger"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyZeroZx%2Fngx-facebook-messenger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyZeroZx%2Fngx-facebook-messenger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyZeroZx%2Fngx-facebook-messenger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkyZeroZx%2Fngx-facebook-messenger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SkyZeroZx","download_url":"https://codeload.github.com/SkyZeroZx/ngx-facebook-messenger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254046288,"owners_count":22005569,"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":["angular","angular-facebook","angular-messenger","facebook-messenger","facebook-sdk","messenger-customer-chat","messenger-customer-plugin","ngx-facebook-messenger"],"created_at":"2024-08-04T01:01:24.941Z","updated_at":"2025-05-14T00:31:17.552Z","avatar_url":"https://github.com/SkyZeroZx.png","language":"TypeScript","funding_links":[],"categories":["Table of contents"],"sub_categories":["Angular"],"readme":"# NgxFacebookMessenger | Angular\n\nAngular component for Facebook Messenger Plugin\n\nNgx Facebook Messenger offers a lightweight alternative, optimizing user experiences by significantly reducing the initial load size, ensuring smoother page performance, and enhancing overall website efficiency\n\nOn May 9 , 2024 Facebook remove Facebook Messenger Plugin chat without replacement\n\nSee https://developers.facebook.com/docs/messenger-platform/discovery/facebook-chat-plugin/\n\nAs an alternative to the change made by Facebook, consider making a change to the library's API to support Link Me for use with Facebook Messenger.\n\nSee https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links?locale=en_US\n\n# DEMO\n\nSee a [live demo](https://skyzerozx.github.io/ngx-facebook-messenger)\n\n## Basic Usage\n\nInit your plugin with previous register your page domain in the white list of Facebook\n\nSet your idMe in ngxFacebookMessengerOptions how the next example\n\n```html\n\u003cngx-facebook-messenger [ngxFacebookMessengerOptions]=\"{ idMe: 'YOUR_ID_ME_LINK'}\"\u003e \u003c/ngx-facebook-messenger\u003e\n```\n\n## Dependencies\n\nLatest version available for each version of Angular\n\n| ngx-facebook-messenger | Angular     |\n| ---------------------- | ----------- |\n| 1.0.0 - 1.2.0          | 16.xx 17.xx |\n| 1.3.0 - 2.0.0          | 17.xx 18.xx |\n\n# Usage\n\n## Install\n\n`npm install ngx-facebook-messenger`\n\n## Import into Module\n\n```typescript\nimport { NgxFacebookMessengerModule } from 'ngx-facebook-messenger';\n\n@NgModule({\n  imports: [\n    ...,\n    NgxFacebookMessengerModule\n  ],\n  declarations: [...],\n  providers: [],\n  bootstrap: [AppComponent]\n})\nexport class AppModule { }\n```\n\n## Customization CSS\n\nFor customized position of plugin and background\n\nIn case the View Button is **ICON**\n\nExample of position left in the plugin with botton 36px , and custom background color\n\n```scss\n#ngx-facebook-messenger {\n  background: #8278ff;\n}\n```\n\nIn case the View Button is **ICON TEXT** or **TEXT**\n\nExample of position left in the plugin with bottom 36px , and custom background\n\n```scss\n#ngx-facebook-messenger {\n  .wrapper {\n    bottom: 36px;\n    right: 0;\n    left: 0;\n  }\n\n  .wrapper-icon-text {\n    left: 12px;\n    background: #8278ff;\n  }\n}\n```\n\nNote : This SCSS code is valid when applied in style base of all proyect , when applied directly in component use !important\n\n# API\n\n# Inputs\n\nIn **NgxFacebookMessengerOptions**\n\n```typescript\nexport interface NgxFacebookMessengerOptions {\n  /**\n   * See{@link https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links?locale=es_ES}\n   * You need id to use link me to redirect to Messager Chat of Facebook Page\n   */\n  idMe: string;\n  /**\n   * Flag to indicate open link when provide propertie idMe\n   * @default true\n   */\n  openLink?: boolean;\n  /**\n   *  ref parameter that, when a person clicks on the link,\n   *  provides your business with more context about the conversation such as a link on your website versus a link in a store.\n   *  See {@link https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links?locale=en_US}\n   */\n  ref?: string;\n  /**\n   * text parameter to include a customized message as well.\n   * See {@link https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links?locale=en_US}\n   *  @default \"Hello\"\n   */\n  text?: string;\n  /**\n   * Button Options for customization similar to a Facebook Plugin Official\n   */\n  buttonOptions?: {\n    /**\n     * Text button when style is VIEW_BUTTON.ICON_TEXT or VIEW_BUTTON.TEXT\n     * @default Chat\n     */\n    text?: string;\n    /**\n     * Enum Options of possible view.\n     * @default VIEW_BUTTON.ICON\n     */\n    view?: VIEW_BUTTON;\n    /**\n     * Enum Options of possible style.\n     * @default STYLE_BUTTON.ROUNDED_LOGO\n     */\n    style?: STYLE_BUTTON;\n    /**\n     * Size options if is desktop or mobile\n     */\n    size?: {\n      /**\n       * Enum Options of possible desktop size.\n       * @default SIZE_BUTTON_DESKTOP.STANDARD\n       */\n      desktop?: SIZE_BUTTON_DESKTOP;\n      /**\n       * Enum Options of possible mobile size.\n       * @default SIZE_BUTTON_MOBILE.COMPACT\n       */\n      mobile?: SIZE_BUTTON_MOBILE;\n    };\n  };\n}\n```\n\n- Enum values\n\n```typescript\nexport enum VIEW_BUTTON {\n  ICON = 'ICON',\n  ICON_TEXT = 'ICON_TEXT',\n  TEXT = 'TEXT',\n}\n\nexport enum STYLE_BUTTON {\n  ROUNDED_LOGO = 'ROUNDED_LOGO',\n  ROUNDED = 'ROUNDED',\n  SQUARED = 'SQUARED',\n}\n\nexport enum SIZE_BUTTON_MOBILE {\n  STANDARD = 'STANDARD_MOBILE',\n  COMPACT = 'COMPACT_MOBILE',\n}\n\nexport enum SIZE_BUTTON_DESKTOP {\n  STANDARD = 'STANDARD_DESKTOP',\n  COMPACT = 'COMPACT_DESKTOP',\n}\n```\n\n# Outputs\n\n| Output           | Description                                                                                                                                                                                                                                            |\n| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| clicked      | Emitted when clicked in Facebook Messenger Icon                                                                                                                                                                                                |\n\n# Methods\n\nThis method should be after init the plugin or throw a error , except **hideNgxFacebookMessenger**\n\n| Method                                    | Description                                                                                                                                                                                                                                                                                                                            |\n| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |        \n| hidePluginChat()                          | Call this function to hide the plugin Chat.                                                                                                                                                                   \n| showPluginChat()                          | Call this function to show the plugin Chat.    \nNote :\nThe documentation of Link Me Facebook Messenger\n\n- https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links?locale=en_US\n\n## Versioning\n\nWe use [SemVer](https://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/zyra/ngx-facebook/tags).\n\n## Contribution\n\n- **Having an issue**? or looking for support? [Open an issue](https://github.com/SkyZeroZx/ngx-facebook-messenger) and we will get you the help you need.\n- Got a **new feature or a bug fix**? Fork the repository, make your changes, and submit a pull request.\n\n## Support this project\n\nIf you find this project useful, please star the repository to let people know that it's reliable. Also, share it with friends and colleagues that might find this useful as well. Thank you :smile:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkyZeroZx%2Fngx-facebook-messenger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSkyZeroZx%2Fngx-facebook-messenger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkyZeroZx%2Fngx-facebook-messenger/lists"}