This page is for developers who are interested in making changes to the Newscoop code. The development environment is not only good for developing Newscoop; it can also be used by people interested in testing the latest builds hot off the Git repository. Once the development environment is installed, users can easily pull down the very latest code from the Git server and run it with minimal effort.
The following steps set up a development environment on a clean Ubuntu installation (version 11.04 and newer).
There are currently two different ways of installing Newscoop and setting up the development environment. It depends on how you get the sources, so:
First option, and most recommended for developers, is by fetching from Git. You get all Newscoop files but you don't get any dependencies, you have to install the dependencies by yourself, making sure you have all those before installing Newscoop.
Second option is to download either the tarball or zip file from Sourceforge. This package does include all required dependencies.
We will try to explain in this guide what to do in both cases to get Newscoop running...
2. Developer Tools (optional - only for developers)
See this page for a number of developer tools you need to get.
3. Getting Newscoop
From the Git repository (Recommended for developers).
Install GIT if you dont have it yet:
You can get the development sources from our public repository at github by doing only this:
Now copy the files to the web root like so
From Sourceforge (Recommended for regular users).
After you download, type the following into your command line:
4. Install Dependencies
For those installing Newscoop from Git.
Open a terminal, and copy and paste the following command into it.
A few of these packages are in the "universe" and "multiverse" repository. If either of these is disabled, then you can enable it either in Synaptic, or by manually editing the file /etc/apt/sources.list (as root).
Updated package list for Ubuntu 11.04 (and up):
The version of Zend framework required by Newscoop is 1.11.5 or newer. This version is not available on Ubuntu 10.04, so to get Newscoop running on it you have two options.
- Download from Sourceforge the latest release file. A proper version of Zend is already included there, so Newscoop will install without any problem.
- Download Zend (1.11.5 or newer) from http://framework.zend.com/download/latest (The Minimal Package is the right one) and install it under the library directory in your Newscoop installation.
You might face conflicts if you have some of these dependencies installed in your system. If you get a blank white screen, check /var/log/apache2/error.log for redeclare errors.
In this case you need to remove(or tweak the path of) the conflicting packages from your system or the newscoop directory. We will deal with this in a smarter way soon so that you do not have to worry about it
For those installing Newscoop tarball or zip files.
5. Configure Apache and PHP
Go to /etc/php5/apache2, and edit php.ini as root.
5.1) PHP "tmp" directory
Find the line:
and set it to:
5.2) Setting the timezone
We also need to set the timezone that the apache webserver is in. Find the line date.timezone, remove the semi-colon in front, and add your timezone to the end. For example:
You can find the correct timezone value for your location by clicking here.
6. Apache Config File
Create the file /etc/apache2/sites-available/newscoop-4.0,
and copy in the information below.
and then from the command line:
Newscopp installer needs permissions for some directories, you can easly fix this with:
Installing Sympfony with Composer
7. Using the Application
Open a web browser and navigate to "http://localhost". If you see the Newscoop installer page, you are ready to proceed through the installation steps.
Newscoop Manual has a detailed guide on Installation that you can also check out in case you get into issues you can't resolve with this guide. This is the URL http://en.flossmanuals.net/newscoop3journalists_en/command-line-installation/.
If you are upgrading your Newscoop installation, please refer to the UPGRADE.txt file in the Newscoop sources for more info about this.
Some common issues with Newscoop Installation:
- The web server user must be able to write to these directories: