Frontend Search for loklak server http://loklak.org
TypeScript HTML CSS Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Updates Pull Request template to contain live surge link (#633) Jan 18, 2018
docs Fixes #809, #821: Add Heroku One-Click deploy, add docs & update READ… Jul 5, 2018
e2e (deps): Dependency Update (#734) Jun 1, 2018
src Fixes #912: Make color and effects of loklak similar to Google (#913) Aug 20, 2018
.editorconfig (feat): Basic File structure Oct 1, 2016
.gitignore Fixes #699: Update gitignore file (#700) Apr 29, 2018
.jshintrc # This is a combination of 3 commits. Sep 23, 2016
.travis.yml Fixes #814: Error in npm sha due to security vulnerability fix (#815) Jul 3, 2018
Dockerfile Fixes #774: Fix Codacy issues (#775) Jun 23, 2018
LICENSE Create LICENSE Dec 5, 2017
README.md Update README.md Jul 22, 2018
angular.json Addresses #758: Fix Tools & Views tab and position of Suggestion Box (#… Jun 22, 2018
app.json Fixes #809, #821: Add Heroku One-Click deploy, add docs & update READ… Jul 5, 2018
codecov.yml Create codecov.yml Jun 8, 2017
deploy.sh Fixes #776: Fix deployment to gh-pages and travis issues (#777) Jun 28, 2018
deploy_key.enc Add deploy key for continuous deployment Oct 11, 2016
package-lock.json Fixes #886: Fix security vulerability for adm-zip (#889) Jul 30, 2018
package.json Fixes #886: Fix security vulerability for adm-zip (#889) Jul 30, 2018
pr_deploy.sh Fixes#610 Auto deployment using Surge (#621) Dec 7, 2017
sass-lint.yml #158 Added scss lint (#159) Jan 3, 2017
server.js Create Heroku deployment Jul 1, 2018
tsconfig.json (deps): Dependency Update (#734) Jun 1, 2018
tslint.json (deps): Dependency Update (#734) Jun 1, 2018

README.md

loklak_search

Join the chat at https://gitter.im/loklak/loklak Code Climate Codacy Badge codecov Percentage of issues still open Average time to resolve an issue

Development: Build Status Master: Build Status

The loklak_search creates a website using the loklak server as a data source. The goal is to get a search site, that offers timeline search as well as custom media search, account and geolocation search.

In order to run the service, you can use the API of https://api.loklak.org or install your own loklak server data storage engine. loklak_server is a server application which collects messages from various social media tweet sources, including Twitter. The server contains a search index and a peer-to-peer index sharing interface. All messages are stored in an elasticsearch index.

The site of this repo is deployed on the GitHub gh-pages branch and automatically deployed here: https://loklak.org. The branches are deployed on Heroku for testing:


Communication

Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/opntec-dev

Our chat channel is on gitter here: https://gitter.im/loklak/loklak

Technology Stack

Components
  • HTML - Structure of the web page generated.
  • CSS - Styling options and details of the web page.
  • JavaScript(JSON) - Used to store information for deploying the application such as dependencies.
  • Angular 6 - Structure for deployment of the web page.
  • Bootstrap 3.3.2 - Responsive Design

Requirements

Installation

First, we will need to install angular-cli by using the following command:

$ npm install -g @angular/cli

After installing angular-cli we need to install our required node modules, so we will do that by using the following command:

$ npm install

How to deploy?

Running on localhost:

  • Step 1: Fork loklak_search repository and clone it to your desktop
  • Step 2: Then cd into that cloned folder
  • Step 3: Deploy locally by running this:$ ng serve

How to use ngrx/StoreDevtools?

  • Step 1: Install the Redux Devtools extension.
  • Step 2: We don't enable the ReduxDevtools by default due to performance considerations. To enable this, un-comment the StoreDevtools import in app.module.ts.

Note: Please make sure that you comment the StoreDevtools import again before making the PR.

For deploying with Surge:

Surge will automatically generate deployment link whenever a pull request passes Travis CI.

Suppose pull request number is 150 and it passes Travis CI. The deployment link can be found here: https://pr-150-fossasia-LoklakSearch.surge.sh

For deploying with Github Pages:

With these very simple steps you can have loklak_search deployed:

  • Step 1: Fork loklak_search repository and clone it to your desktop
  • Step 2: Then check out to your master branch $ git checkout master
  • Step 3: Deploy running this: $ npm run deploy
  • Step 4: Visit https://yourusername.github.io/loklak_search and you should see the search running
  • Step 5: As you search you might see that it can't find anything, to resolve this, on search you will see there is a red shield on search bar, click on it and allow to load scripts
  • Step 6: Reload and you will have a function loklak search page deployed with github pages.

For deploying with Heroku:

loklak_search can be deployed on Heroku using:

  1. Deployment on Heroku

One-click Heroku deployment is also available:

Deploy

Loklak Server

See here to run your own https://github.com/loklak/loklak_server (recommended), and change apiUrl in config accordingly. Last resource, or for production is https://api.loklak.org

Contributions, Bug Reports, Feature Requests

This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests, submitting the pull requests as well. Please report issues in the GitHub tracker.

Branch Policy

We have the following branches:

  • development All development goes on in the development branch. If you're making a contribution, please make a pull request to development. PRs to the branch must pass a build check and a unit-test check on Travis (https://loklak-search.herokuapp.com - Is running off the latest development branch).
  • master This branch contains shipped code. After significant features/bug-fixes are accumulated on development, development branch is merged into master branch. (https://loklak.org - Is running off the lastest master branch.).
  • gh-pages This contains the autogenerated code of the master branch that is generated by Travis.

License

This project is currently licensed under GNU Lesser General Public License v3.0. To obtain the software under a different license, please contact FOSSASIA.