{"id":20542366,"url":"https://github.com/artcodestudio/facebook-events-october-plugin","last_synced_at":"2025-10-07T03:39:36.913Z","repository":{"id":134110647,"uuid":"285534389","full_name":"ArtCodeStudio/facebook-events-october-plugin","owner":"ArtCodeStudio","description":"An October CMS Plugin which pulls Events form Facebook Pages","archived":false,"fork":false,"pushed_at":"2020-11-11T14:40:58.000Z","size":3209,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-25T22:59:26.646Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArtCodeStudio.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":"2020-08-06T09:51:57.000Z","updated_at":"2023-07-09T16:31:57.000Z","dependencies_parsed_at":"2024-08-13T23:00:26.124Z","dependency_job_id":null,"html_url":"https://github.com/ArtCodeStudio/facebook-events-october-plugin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCodeStudio%2Ffacebook-events-october-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCodeStudio%2Ffacebook-events-october-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCodeStudio%2Ffacebook-events-october-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtCodeStudio%2Ffacebook-events-october-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArtCodeStudio","download_url":"https://codeload.github.com/ArtCodeStudio/facebook-events-october-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242148049,"owners_count":20079680,"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":[],"created_at":"2024-11-16T01:31:40.594Z","updated_at":"2025-10-07T03:39:31.895Z","avatar_url":"https://github.com/ArtCodeStudio.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"## I.) Documentation\nAfter installing the plugin you will find settings for the Facebook Events in **Settings -\u003e Misc -\u003e Facebook Events** and an additional item \"Manual Events\" in the backend top navigation.\n\n#### Facebook Settings Tab\nThis tab offers the choice to display Facebook page events, manual entered events or both.\nManual events can be maintained under the Manual Events top-menu section. \n*see II.) Manual Events Topic below*\n   \nIf you want to include events from a Facebook page, you have to register a Facebook 'app' for it and enter certain credentials, to authorize your app with the Facebook API server.  \nThe steps to complete for this are as follows:\n\n##### 1.) Create a new App\nFirst, we need to create a new Facebook app.\nCreate an account at https://developers.facebook.com, if you don't have one.\nThen follow the [Facebook documentation](https://developers.facebook.com/apps/) on how to add a new app.\n\n![](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/Add_new_App.png)\n\nChoose **Manage Business Integrations** as the app type:\n\n![https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/app_type.png](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/app_type.png)\n\nThe **App Display Name** is up to you.    \nEnter your **App Contact Email** and set **App Purpose** to **Yourself or your own business**  \nCongratulation, now you are ready to click the the **Create App ID button** !\n\n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/create_app.png)\n\n###### 2.) Setup Facebook Login\nOnce you created the app,  navigate to the **Facebook Login Setting**: \n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/facebook_callback.png)\nThe only thing we need to add here is the callback URL on your server.\nhttps://yourdomain.net/facebook_callback   \nSave Changes\n\n######  3.) Obtain Credentials\nNavigate to Settings / Basic:\n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/app_setting_basic.png)\n\n\nThere you find the required credentials.\nCopy the **App ID** and **App Secret**'to the OctoberCMS Facebook Events Plugin's (Setting -\u003e Misc -\u003e Facebook Events) appropriate inputs and add your Event Page name and click **Save**. \n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/plugin_settings.png)\n\n\nOnce you pressed the **Save** button you will be redirected to Facebook to review the permissions you about to acquire. \n\n \nAfter completion you'll get redirected to the Facebook Event Settings Page, where you can verify that the *App Token* field has been populated. \nThe *App Token* Info Section displays if the token is valid and when it expires.\nHere you can also renew the current token as well as change permissions.\n\n######  4.) Obtain Credentials\nSince the configuration is now done, you are ready to Login to Facebook and authorize your app.\nClick 'Click here to login' this will take you to Facebook.\nHere you select the page you like to use and click 'next'.\nConfirm the process by clicking 'done' and 'OK' on the following pages.\nAfter that, you get redirected to your 'Facebook Events' Plugin Settings.\nHere you can verify that the APP TOKEN field is now populated as well as the Access and Data Access Token details.\n\n##### Facebook Events Tab\nThe Event Cache TTL setting defines how long Facebook page events should be cached to reduce the number of API requests to Facebook - (default: 600s = 10m)  \nThe 'Fields to include section' lets you select which data should be rendered in the eventlist component.\n\n## II.) Manual Events\nThese Events are created under the Manaual Events Top Navigation Section. Here you can create new Events or edit existing:\n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/manual_events_section.png)\n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/manual_events_create_update.png)\n\n\n\n## III.) Custom Event Component\nTo override the Plugin default component view,  \ncopy the ```default.html``` from ```plugins/artandcodestudio/facebookevents/components/eventlist/default.htm``` to ```/themes/yourtheme/partials/eventlist/default.htm``` and change the markup according to your needs and wishes.\nsee ![OctoberCMS Documentation](https://octobercms.com/docs/cms/components#overriding-partials)\n\n## IV.) Routes\nFacebook Callback Route: /facebook_callback\n\n\n-------\nAt some point you may encounter a message like this: \n![enter image description here](https://raw.githubusercontent.com/ArtCodeStudio/facebookevents-october-plugin/master/docs/images/app_review.png)  \n\nApps only need to be sent into review if you plan to make it public and usable by others, so this can be ignored in our case.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcodestudio%2Ffacebook-events-october-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartcodestudio%2Ffacebook-events-october-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcodestudio%2Ffacebook-events-october-plugin/lists"}