poderopedia / plug-and-play-1.0-rc Goto Github PK

Poderopedia Plug & Play Platform Release Candidate

CSS 14.94% Ruby 0.01% Python 24.64% JavaScript 58.22% XSLT 0.21% Perl 0.11% PHP 0.83% ASP 0.65% Shell 0.01% CoffeeScript 0.38%

plug-and-play-1.0-rc's Introduction

About Plug & Play

Poderopedia Plug & Play Platform is a Data Intelligence Management System that allows you to create and manage large semantic datasets of information about entities, map and visualize entity connections, include entity related documents, add and show sources of information and news mentions of entities, displaying all the information in a public or private website, that can work as a standalone product or as a public searchable database that can interoperate with a Newsroom website providing rich contextual information for news content using it`s archive.

Poderopedia Plug & Play Platform is a free open source software (see License) developed by the Poderomedia Foundation, thanks to the generous support of a Knight News Challenge 2011 grant by the Knight Foundation, a Startup Chile 2012 grant and a 2013 fellowship grant by the International Center for Journalists (ICFJ), to: a) Develop Poderopedia.org, a collaborative data journalism website that maps who is who in politics and business, and... b) Develop the Plug & Play Platform and release it for anyone to use it.

You can fork this project and deploy it with your own modifications. Please see the License file for details.

#Getting help If you'd like to contribute to Poderopedia Plug & Play Platform or need some assistance, please open an issue or do a pull request. We will do our best to answer and include your changes when possible.

What's included in this Documentation

This Documentation includes all the necessary elements and information for installing, setting up and customizing the Poderopedia Plug & Play Platform for your project, including the technical documentation and open source technology used in the platform (see Technology) so you can run the Platform and Website/s as you see fit.

The goal of this Documentation is to explain step by step what you need and have to do to setup a standalone instance of Poderopedia Plug & Play Platform, to be used in your project with multiuser self administration system that will allow you to run and mantain a public website and semantic searchable database of entities, connections between entities, profiles of entities, maps of connections of entities, documents, sources and news related to entities.

The Poderopedia Plug & Play Platform will also allow you to receive, vet and manage collaborations from registered users and be approved or rejected by your project editors in the Plug & Play Management system.

INDEX

1.- What is Plug & Play?

2.- Features

3.- Technology

4.- Installing

5.- Web server configuration

6.- Settings

Setting up Plug & Play
Setting up PoderVocabulary
Setting up Solr
Setting up Documentcloud

7.- Customizing your Plug&Play appearance

8.- API Documentation

9.- User Manual Plug & Play

10.- Supporters and License

plug-and-play-1.0-rc's People

Contributors

Stargazers

Watchers

Forkers

wchorolque zawszaws eklipsi antoniomilanese vsusarla code4sa jasonmailley imclab mariacrosas jnaudon vconuepan afbayonac javadboloori admariner

plug-and-play-1.0-rc's Issues

Document how to actually run poderopedia

It seems you need to run web2py in the parent directory, but this isn't documented anywhere.

I'm trying to run poderopedia, but won't get web2py to recognize and initialize the application - do you have any debugging advice?

Separate configuration from database model

There seems to be a lot of configuration code in the database model. Splitting these up might make for a clearer separation of concerns.

https://github.com/poderopedia/plug-and-play-1.0-RC/blob/master/poderopedia/models/db.py#L112

The template app requires more documentation

The template app have no about or readme

Separate database access from javascript

In db.py, some queries directly generate JS code. This should be channeled through an API instead.

see: https://github.com/poderopedia/plug-and-play-1.0-RC/blob/master/poderopedia/models/db.py#L267

Translate database schema to English

This would make it significantly easier to reverse-engineer the way poderopedia is supposed to work.

Refs. #2.

Error Preloading database

I'm getting this error preloading the databases.

1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.	Traceback (most recent call last): File "/usr/lib/python2.7/dist-packages/gluon/main.py", line 447, in wsgibase serve_controller(request, response, session) File "/usr/lib/python2.7/dist-packages/gluon/main.py", line 188, in serve_controller page = run_controller_in(request.controller, request.function, environment) File "/usr/lib/python2.7/dist-packages/gluon/compileapp.py", line 634, in run_controller_in restricted(code, environment, filename) File "/usr/lib/python2.7/dist-packages/gluon/restricted.py", line 227, in restricted exec ccode in environment File "/usr/share/web2py/applications/admin_app/controllers/install.py", line 101, in File "/usr/lib/python2.7/dist-packages/gluon/globals.py", line 412, in self._caller = lambda f: f() File "/usr/share/web2py/applications/admin_app/controllers/install.py", line 9, in index from setup.setup import SetupPopulate File "/usr/lib/python2.7/dist-packages/gluon/custom_import.py", line 74, in custom_importer return NATIVE_IMPORTER(oname, globals, locals, fromlist, level) File "/usr/lib/python2.7/dist-packages/gluon/packages/dal/setup.py", line 46, in 'Topic :: Software Development :: Libraries :: Python Modules' File "/usr/lib/python2.7/distutils/core.py", line 139, in setup raise SystemExit, gen_usage(dist.script_name) + "\nerror: %s" % msgSystemExit: usage: web2py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] or: web2py --help [cmd1 cmd2 ...] or: web2py --help-commands or: web2py cmd --helperror: option -a not recognized

any ideas?

Add documentation about adding new relationship types

It would be good to explain how to add and edit new relationship types of the Ontology and provide a interface to edit such schemata in Plug & Play

PDF manual requires update

The information need to move to the wiki page

Instructions for installing on Heroku / other PaaS

I'd love to have simple instructions for getting this up and running on Heroku or other PaaS system that supports python.

Heroku even has a Solr add-on: https://devcenter.heroku.com/articles/websolr

Missing controller code

The following controllers / functions have navigational elements in the views, yet seem to be missing from the code. Is there a plan to include these in the source?

directorio/general (controller, with functions: persona, empresa, organazacion)

also:

personas/mapa_relaciones

Problem with setup of Poderopedia

Hi Folks,

I am getting a

ProgrammingError: ('ERROR', '42P01', 'relation "auth_user" does not exist') when I try to run the poderopedia application from http://localhost:8000/admin/default/site.

The traceback shows (among many others), this line

File "C:\Program Files\AIA\Project\web2py\applications\poderopedia\models\db_colaboracion.py", line 15, in

When change the migrate = True to False in the db_colaboracion.py (table name: actualizacion)

It create the table, but I get another error

ERROR', '42P01', 'relation "plugin_stats" does not exist'). I am a newbie and have limited knowledge of web2py and poderopedia. Any help would be greatly appreciated

Make automatized installation script using Fabric

The goal of this script is to reduce the amount of steps and time required to install Plug & Play on other platforms. (See Fabric, python library and command-line tool for streamlining the use of SSH for application deployment or systems administration tasks). http://fabric.readthedocs.org/en/latest/

Documentation

The Readme in the documentation requieres update

Pre populate database

I have cloned the last version of Plug and Play 1.0 RC and i have problems setting up the database for the platform.

Steps:

Install web2py
cd web2py; rm -rf applications
git clone https://github.com/poderopedia/plug-and-play-1.0-RC applications
Modify settings at applications/admin/models/0.py:
settings.migrate = True
settings.database_uri = 'mysql://myuser:mypass@localhost/mydatabase'
Then i go to http://localhost:8000/admin or http://localhost:8000/admin/install

I have tested several combinations with the same result: Ubuntu 12.04 and Mac Os X 10.8 with Mysql 5.1, PostgreSQL 9.1 and Python 2.7

After perform this steps i'm always getting this message on applications/admin/errors:

S'"INSERT INTO auth_user(username,city,first_name,l...ps it. ','[email protected]','Graig Groshek');"'
p184
sS'self'
p185
S'<gluon.dal.PostgreSQLAdapter object>'
p186
sS'e'
S'ProgrammingError('ERROR', '23503', 'insert or up...foreign key constraint "auth_user_country_fkey"')'
p187
sS'fields'
p188
S"[(<gluon.dal.Field object>, 'rocky5445'), (<gluon.dal.Field object>, 'James matter exist in the floor of the sea. the behaviour. '), (<gluon.dal.Field object>, 'Hiroko'), (<gluon.dal.Field object>, 'Dinneen'), (<gluon.dal.Field object>, None), (<gluon.dal.Field object>, 'Successful. Huxley regarded as we are concerned chiefly in s'), (<gluon.dal.Field object>, 'Breach of the oval than an ether and moon showing a. '), (<gluon.dal.Field object>, 44), (<gluon.dal.Field object>, 'Weathered by the open sea.\nHe was too faint indi...ological proof of knowledge of the caterpillars.\n'), (<gluon.dal.Field object>, 'Pigments compounded of a great southward migration; and ever'), (<gluon.dal.Field object>, None), (<gluon.dal.Field object>, 'Beside it was no larger in which separates monkeys other spi'), (<gluon.dal.Field object>, datetime.datetime(2013, 6, 27, 15, 10, 25, 177807)), (<gluon.dal.Field object>, None), (<gluon.dal.Field object>, '1548 Alonzo Weerts Street'), (<gluon.dal.Field object>, datetime.datetime(2013, 6, 27, 15, 10, 25, 177807)), (<gluon.dal.Field object>, ''), (<gluon.dal.Field object>, 'Parachuting. If the egg signalling to be asked perhaps it. '), (<gluon.dal.Field object>, '[email protected]'), (<gluon.dal.Field object>, 'Graig Groshek')]"
p189
sS'table'
p190
S'<Table auth_user (id,username,first_name,last_na...stration_key,reset_password_key,registration_id)>'
p191
sssS'traceback'
p192
S'Traceback (most recent call last):\n File "web2py/gluon/restricted.py", line 212, in restricted\n exec ccode in environment\n File "web2py/applications/admin/models/db_wizard_populate.py", line 3, in \n populate(db.auth_user,10)\n File "web2py/gluon/contrib/populate.py", line 104, in populate\n table.insert(**record)\n File "web2py/gluon/dal.py", line 8598, in insert\n ret = self._db._adapter.insert(self, self._listify(fields))\n File "web2py/gluon/dal.py", line 1210, in insert\n raise e\nProgrammingError: ('ERROR', '23503', 'insert or update on table "auth_user" violates foreign key constraint "auth_user_country_fkey"')\n'

Follow REST paradigm for the API

The API currently seems a bit random, and read-only. It would be great to have a full REST API to retrieve and manipulate information stored in Poderopedia. Ideally, the Poderopedia frontend should use only this API with the admin app and not require a second copy of the database model in its code.

'AutocompleteWidget' object has no attribute 'help_field'"

On a fresh new install i added two persons, then i try to stablish a relationship between them and i get this message: "An error ocurred, please reload the page".

If i reload the page, the error message appears again.

When i look the error log file, i get this:

(dp1
S'output'
p2
S"<type 'exceptions.AttributeError'> 'AutocompleteWidget' object has no attribute             'help_field'"
p3
sS'layer'
p4
S'/Users/mabahamo/Downloads/web2py/applications/admin/models/db.py'

Full error log message on: http://pastebin.com/d1G07ZmY

Language issues

Hey,

I just wanted to point out that in order to ease adoption and collaboration from developers outside of Poderopedia, variable names, method names and comments should be in english.

For instance:

def sugerir_persona() should be def suggest_person()

Just my two cents.

Congratulations on the release!