Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hellowin/kanca
Facebook Group Analytics
https://github.com/hellowin/kanca
bithound community community-engagment community-management facebook facebook-graph-api facebook-groups facebook-login flow github-page
Last synced: 5 days ago
JSON representation
Facebook Group Analytics
- Host: GitHub
- URL: https://github.com/hellowin/kanca
- Owner: hellowin
- License: mit
- Created: 2017-04-10T03:30:18.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-09T06:29:05.000Z (2 months ago)
- Last Synced: 2024-09-09T07:55:44.120Z (2 months ago)
- Topics: bithound, community, community-engagment, community-management, facebook, facebook-graph-api, facebook-groups, facebook-login, flow, github-page
- Language: CSS
- Homepage: https://hellowin.github.io/kanca/
- Size: 4.85 MB
- Stars: 33
- Watchers: 7
- Forks: 12
- Open Issues: 92
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - hellowin/kanca - Facebook Group Analytics (others)
README
![Kanca logo](https://github.com/hellowin/kanca/blob/master/public/img/logo.png)
[![Build Status](https://travis-ci.org/hellowin/kanca.svg?branch=master)](https://travis-ci.org/hellowin/kanca)
[![codecov](https://codecov.io/gh/hellowin/kanca/branch/master/graph/badge.svg)](https://codecov.io/gh/hellowin/kanca)
[![Known Vulnerabilities](https://snyk.io/test/github/hellowin/kanca/badge.svg)](https://snyk.io/test/github/hellowin/kanca)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/34810083c2eb4046a67dba2959dcca9f)](https://www.codacy.com/app/hellowin/kanca?utm_source=github.com&utm_medium=referral&utm_content=hellowin/kanca&utm_campaign=badger)
[![Code Climate](https://codeclimate.com/github/hellowin/kanca/badges/gpa.svg)](https://codeclimate.com/github/hellowin/kanca)Kanca is an application to analyze `Facebook Group` activity. Its key features are:
- **Open sourced**, as you can see here.
- **Fully client side**, hosted on GitHub pages (zero cost, no data persisted on server).
- Analyze user FB group feed behavior like most active users, most liked posts, etc.
- Analyze FB group user engagement like new users, user retention, etc.# Local Development
## Requirements
1. Node.js 6+
2. Facebook Developer's Application, create it at [https://developers.facebook.com](https://developers.facebook.com) for free
3. Make sure you enabled Facebook Login feature and put `http://localhost:3000` exist in your `Valid OAuth redirect URIs` (Facebook Login -> Settings)## Installation
1. Go to project root directory, copy `.env.template` to `.env` (edit it as you need, look at description below)
2. Install its dependencies `$ npm install` or `$ yarn install`## IDE/ Text Editor/ OS Configuration
Since this project uses [Flow](https://flow.org/), and some environment specific configuration, some IDE or Text Editors needs additional configuration.
### Windows
Please use `Bash on Ubuntu on Windows` or `Windows Subsystem Linux` for local development.
### VSCode
Add `"javascript.validate.enable": false` on your VSCode config (`.vscode/settings.json`).
It would be better if you install this [Flow plugin](https://marketplace.visualstudio.com/items?itemName=flowtype.flow-for-vscode) as well.
## Development
1. Run `$ npm start` or `$ yarn start`
2. Open browser at `http://localhost:3000`## Environment Variable Explanation
- `REACT_APP_FB_APP_ID` it's Facebook Developer's Application ID, look at your application dashboard on https://developers.facebook.com.
- `REACT_APP_URL_PREFIX` default is `/kanca`, it's used as a `url prefix`, mostly used if we published as project page at GitHub pages.
- `REACT_APP_FEED_PAGES` default is `10`, it's used to set how many pages of group feed do we want to fetch by default.
- `REACT_APP_GROUP_IDS` Facebook Group IDs to be shown at `featured groups` on group selection, eg. `1920036621597031` for `Facebook Developer Circle: Malang` group. Separated by commas `,`.# Roadmap
To track development progress and roadmap, follow this [GitHub Project](https://github.com/hellowin/kanca/projects).
# License
[MIT](https://github.com/hellowin/kanca/blob/master/LICENSE)