Events portal

.gitignore

@@ -19,7 +19,7 @@
 .AppleDouble
 .DS_Store
 .c9revisions
-
+*.kate-swp
 # Server config files
 restart-project.sh
 
@@ -34,6 +34,7 @@ files/media/*
 files/static-collected/*
 files/static/img/fest_pics/*
 files/static/json/*
+files/static-root/*
 files/templates/base/meta.html
 static-permission.sh
 runscript.c

README.md

@@ -1,16 +1,25 @@
-fest-api
+Fest-API
 ========
 
 An API implementation for Saarang Shaastra like fests, including ERP and Mainsite and Mobile interface
 
 1. Setup :
+	- Check your dependencies
+		- You need python 2.7.x+ and django 1.6.5 to use this. You can check it with :
+		```
+			# python -c "import django; print(django.get_version())"
+		```
+			If it gives `1.6.5` Then continue. Else, uninstall and reinstall django
+		- Install pip using [this](http://pip.readthedocs.org/en/latest/installing.html)
+		- Install 
+		```
+			python-virtualenv libmysqlclient-dev python-dev mysql-server mysql-client
+		```
 	- Create a virtual env
-		- install `python-virtualenv`
 		- Go into the folder of the git repository and use `virtualenv --no-site-packages venv`
-		- ##If you do not know what git repository means read 'http://rogerdudler.github.io/git-guide/' for a begginer crash course
-		- ##If you do not know what python-virtualenv means read 'http://www.pythonforbeginners.com/basics/python-virtualenv-usage'   
+		- If you do not know what git repository means read [this](http://rogerdudler.github.io/git-guide/) for a begginer crash course
+		- If you do not know what python-virtualenv means read [this](http://www.pythonforbeginners.com/basics/python-virtualenv-usage)
 	- Install configs/requirements.txt
-		- - Install `libmysqlclient-dev python-dev` using 'apt-get install libmysqlclient-dev python-dev'
 		- use 
 			```
 			pip install -r configs/requirements.txt (read 8.c if pip is not installed. 
@@ -19,174 +28,86 @@ An API implementation for Saarang Shaastra like fests, including ERP and Mainsit
 			```
 			pip install -r configs/requirements.txt --upgrade
 			```
-	- Install `libmysqlclient-dev python-dev` if not already installed
-	- (If a previous version of django is already installed or if you are not sure if you have a previous version read 8.d)
-
-2. Change the following in the fest-api/configs/sample.setting.py
+2. Changes required - which are in gitignore
+	- Create a file named conigs/settings.py anf copy everything from config/settings.sample.py. Change the following in the fest-api/configs/settings.py
+		- Set the database settings. Use the following to create a database :
+		```
+			# mysql -u root -p
+			mysql> CREATE DATABASE fest_api_db;
+		```
+		Change the DATABASE lines in settings.py to :
+		```
+			'ENGINE':'django.db.backends.mysql',
+        	'NAME': 'fest_api_db',
+    	    'USER': 'root',
+         	'PASSWORD': '<YOUR_PASSWORD>',
+         	'HOST': '',
+        	'PORT': '',
+		```
+		- In globalsettings.py set 'USE_EXTERNAL_SITES' to False - This will disable google docs for now
+		- In terminal type 'python manage.py syncdb' followed by 'python manage.py migrate'.
+	- Create a blank document called meta.html in files/templates/base/
 
-	- Change the filename to setings.py
-	- Set the database settings (If you need details on how to do this read 8.a. If you are having problems with mysql installation follow 8.b)
-	- (specific to ERP) In globalsettings.py set  'USE_EXTERNAL_SITES' to False 
-	- In terminal type 'python manage.py syncdb' followed by 'python manage.py migrate'. If these 2 worked your database settings worked fine
 
+3. Setup Database :
+
+	- Management command `populate_db` can be used to get dummy data (IMPORTANT)
+
+	- Management command `add_colleges` is used to populate some data - Colleges from Shaastra 2014 (optional) (In other words type 'python manage.py add_colleges')
 
-4. Tastypie (NOT NEEDED for ERP)
-    - Till now, tastypie(v1.11) has some issues with through tables.
-    - Need to replace (in the save_m2m function ~line 2300): 
-
-    	```
-     	related_mngr.add(*related_objs)
-     	```
-      with :
-      	```
-      	if hasattr(related_mngr, 'add'):
-			related_mngr.add(*related_objs)
-		else:
-			# handle m2m with a "through" class
-			for other_obj in related_objs:
-				related_mngr.through.objects.get_or_create(**{
-					related_mngr.source_field_name: bundle.obj,
-					related_mngr.target_field_name: other_obj
-				})
-		```
+	- Management command `update_email_templates` is used to update email templates and store onto the database for Django Post office (optional)
+
+	- Management command `jsonify_data` is used by atwho for data. Autogenerates some json objects which are easy to use
+
+	- Management command `fix_permissions` is used to fix all permissions for the users in the beginning
 
-4.  Setup Social Accounts : (NOT NEEDED for ERP)
+4. Setup Social Accounts : (NOT REQUIRED)
 
-	. FACEBOOK
+	- FACEBOOK
 		- Add your facebook credentials (token, key) into settings
 
-	. GOOGLE
+	- GOOGLE
 		- Go to `{{SITE_URL}}/docs/refresh_token` to create a new refresh token.
 		- This will ask access to a Google account - use the account on which to store Docs and accept.
 		- Now this will store the refresh_token in a configs file and ask you to restrat server.
 		- Restart Server to refetch all settings.
 		- Now you can access Google Drive and Google Picker API
 
 		- Also, add google credentials into settings
-			- Gogole Public Key
+			- Google Public Key
 			- Google oauth configs into configs/docs_oauth2_credentials.json
-
-	. GITHUB
-		- Add your github credentials (token, key) into settings
-
-
-5. Setup Database Appropriately :
-
-	. Management command `add_colleges` is used to populate some data - Colleges from Shaastra 2014 (optional) (In other words type 'python manage.py add_colleges')
-
-	. Management command `update_email_templates` is used to update email templates and store onto the database for Django Post office (optional)
-
-	. Management command `populate_db` can be used to get dummy data (IMPORTANT)
 
-	. Management command `jsonify_data` is used by atwho for data. Autogenerates some json objects which are easy to use
-
-	. Management command `jsonify_data` is used to fix all permissions for the users in the beginning
-
-6. Haystack and Solr
-	. Commands  to install Solr:
-	```curl -O https://archive.apache.org/dist/lucene/solr/3.5.0/apache-solr-3.5.0.tgz
-	tar xvzf apache-solr-3.5.0.tgz
-	cd apache-solr-3.5.0
-	cd example
-	java -jar start.jar```
-	. Next, generate schema from ```python manage.py build_solr_schema```. Take the output from that command and place it in ```apache-solr-3.5.0/example/solr/conf/schema.xml```. Then restart Solr
-	. Solr needs to be run continuously on server
-	. Ref: http://django-haystack.readthedocs.org/en/latest/installing_search_engines.html
-
-
-7. (specific to ERP)(Create a blank document called meta.html in files/templates/base/
+5. Search using Solr (NOT REQUIRED)
 
+	- Commands  to install Solr:
+		```
+		curl -O https://archive.apache.org/dist/lucene/solr/3.5.0/apache-solr-3.5.0.tgz
+		tar xvzf apache-solr-3.5.0.tgz
+		cd apache-solr-3.5.0
+		cd example
+		java -jar start.jar
+		```
+	- Next, generate schema from 
+		```
+		python manage.py build_solr_schema
+		```
+	- Take the output from that command and place it in 
+		```
+		apache-solr-3.5.0/example/solr/conf/schema.xml
+		```
+	- Then restart Solr : Solr will be continuously running on server, like Apache
+	- [Reference](http://django-haystack.readthedocs.org/en/latest/installing_search_engines.html)
 
-8. Common Installation Problems
-
-- At any point if you get permission denied type 'sudo' followed by the required command
-
-8.a. - Details on how to set up MySQL Server. 
-
-	To run the mysql prompt and create a database in the terminal type
-
-		mysql -u root -p
-		##Then type the root user password or set the password if it asks you to
-		## The MySQL shell should open. type-  CREATE DATABASE django_db;
-		## In settings.py under the database settings add 
-
-	        'ENGINE':'django.db.backends.mysql',
-        	'NAME': 'django_db',
-        	'USER': 'root',
-       		 'PASSWORD': whatever you set while creating the database,
-       		 'HOST': '',
-        	'PORT': '',
-	- In terminal type 'python manage.py syncdb' followed by 'python manage.py migrate'. If these 2 worked your database settings worked fine	
-
-
-
-8.b. For mysql installation problems
-
-	- Type the all of the following commands to delete any version of mysql that you have
-
-		sudo apt-get remove --purge mysql-server mysql-client mysql-common
-		sudo apt-get autoremove
-		sudo apt-get autoclean
-	- To install mysql
-
-		sudo apt-get install mysql-server mysql-client
-		sudo apt-get install python-mysqldb
-	- To run the mysql prompt and create a database
-
-		mysql -u root -p
-		##Then type the root user password or set the password if it asks you to
-		## The MySQL shell should open. type-  CREATE DATABASE django_db;
-		## In settings.py under the database settings add 
-
-		'ENGINE':'django.db.backends.mysql',
-        	'NAME': 'django_db',
-        	'USER': 'root',
-       		 'PASSWORD': whatever you set,
-       		 'HOST': '',
-        	'PORT': '',
-	- In terminal type 'python manage.py syncdb' followed by 'python manage.py migrate'. If these 2 worked your database settings worked fine	
-
-8.c. If pip is not installed check the following link
-
-http://pip.readthedocs.org/en/latest/installing.html
-
-
-8.d. If an older version of django is installed or you are unsure of the version. Type the following in terminal
-
-	- python #(to enter python shell)
-	- import django #(if youn get an error here, django is not installed)
-	- print(django.get_version())
-
-    if the version is 1.6.5 you are fine. If not then read on - you will have to delete and reinstall django. Tpe the following
-
-	- python -c "import sys; sys.path = sys.path[1:]; import django; print(django.__path__)"
-	- cd <type the output from the above command until the site-packages file only. e.g /....../sitepackages>
-	- sudo rm -rf django
-	- pip install Django==1.6.5
-    Now repeat the steps till 'print(django.get_version())' to check your django version
-
-
-8.e. static files are not loading Or the css files are not showing
-
-	- set STATIC_URL to '/static/' in settings.py
-
-8.f. Static(css/js) files are loading but not getting the shaastra/saarang logo on the login page
-
-	- go to files/static/img/shaastra_pics Copy login_page_logo.jpg
-	- go to files/static/img/ . Create a folder called fest_pics and paste the photo there (since the src attribute for that photo is files/static/img/fest_pics)
-
-
-8.g. The following error is showing on the browser -  The storage backend of the staticfiles finder <class 'django.contrib.staticfiles.finders.DefaultStorageFinder'> doesn't have a valid location.
-
- 	- In global_settings.py remove the following line in Staic_file_finders 'django.contrib.staticfiles.finders.DefaultStorageFinder',
-
+6. Common Installation Problems
+	- At any point if you get permission denied type 'sudo' followed by the required command
 
-8.h. Some Module like apiclient, south or any app mentioned in the Third-Party-Apps in globalsetings.py is not installed. 
+	a. Static files are not loading Or the css files are not showing - set STATIC_URL to '/static/' in settings.py
 
-	- Google 'install apiclient library' or whatever the module name is and type the command that you find in any of the results in terminal
+	b. If you get the error meta.html not found - set STATIC_URL to '/static/' in settings.py
 
+	c. Static(css/js) files are loading but not getting the shaastra/saarang logo on the login page
+		- copy `files/static/img/shaastra_pics` to `files/static/img/fest_pics` or `files/static/img/saarang_pics` to `files/static/img/fest_pics`
 
-------------------------------------------------------------------------------------------------------
+	d. Some Module like apiclient, south or any app mentioned in the Third-Party-Apps in globalsetings.py is not installed. 
 
-Experimental Features :
- - Content Editable divs
+		- Google 'install apiclient library' or whatever the module name is and type the command that you find in any of the results in terminal

apps/api/gcm.py

@@ -0,0 +1,40 @@
+from django.db.models.query import QuerySet
+from push_notifications.models import GCMDevice
+#serializers
+
+from django.http import Http404
+from rest_framework import viewsets
+from rest_framework.response import Response
+from rest_framework import status
+
+def send_push(object, message):
+    # imported inside function due to circular import 
+    from push_notifications.models import GCMDevice
+    from django.contrib.auth.models import User
+    from apps.users.models import Dept, Subdept, Page
+    if isinstance(object, User):
+        devices = GCMDevice.objects.filter(user=object)
+    if isinstance(object, Dept) or isinstance(object,Subdept) or isinstance(object, Page):
+        users= object.related_users()
+        devices = GCMDevice.objects.filter(user__in=users)
+
+    if isinstance(object, list):
+        object=list(object)
+        if isinstance(object[0],User):
+            devices=GCMDevice.objects.filter(user__in=object)
+
+    devices.send_message(message)
+
+class GCMViewSet(viewsets.ModelViewSet):
+    """
+    Used for associating users and their phones the first time the login 
+    to send push push notifications
+    """
+    model=GCMDevice
+    # def post(self, request, format=None):
+    #     from apps.api.serializers import GCMDeviceSerializer
+    #     serializer = GCMDeviceSerializer(data=request.DATA)
+    #     if serializer.is_valid():
+    #         serializer.save()
+    #         return Response(serializer.data, status=status.HTTP_201_CREATED)
+    #     return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)