FAQ
From GregariusWiki
[edit] About Gregarius
[edit] What is Gregarius?
Gregarius is a web-based RSS/RDF/ATOM feed aggregator. It was designed to run on your web server, allowing you to access your news sources from wherever you want.
[edit] Why is it called Gregarius?
Marco named it after the Latin word "Gregarius" which means belonging to a herd or flock," from grex, greg-, "herd, flock."
[edit] How much does it cost?
Gregarius is free software, released under the GNU General Public License.
[edit] Where can I download Gregarius?
Gregarius can be freely downloaded from the Gregarius sourceforge.net download page.
[edit] Where can I ask for help?
If your question is not answered by this FAQ, head over to the Support Forums or browse the gregarius-dev archives or contact the developers by email.
[edit] I've found a bug! What should I do?
Please head over to the Gregarius issues tracker and skim through the list of known issues to make sure your bug hasn't been reported yet. If this is not the case please create a new bug report. Be as descriptive as possible:
- Specify which version of Gregarius you are using.
- If you think this is relevant, also specify the operating system hosting the web server and which web browser you are seeing this bug on.
After your bug report has been filed you may wish to follow the development timeline to see when your bug has been taken care of or even better: subscribe to the timeline RSS feed.
[edit] Using Gregarius
[edit] How do I secure the Administration area?
Refer to Password-protecting the admin section
[edit] Why do some Gregarius pages return a 404 error?
These errors are usually caused by a problem in the mod_rewrite rules defined in a subdirectory of your webserver.
If the front page (index.php) loads correctly but some of the other pages are giving you a 404 error, try the following :
- Make sure the mod_rewrite is installed and enabled in your web server’s configuration file
- Rename the “rss” directory to “gregarius“, for example
- Make sure that your apache configuration file has an “AllowOverride All” directive for the directory Gregarius is installed in.
- In Gregarius’ .htaccess file, right under “RewriteEngine on“, (Assuming that you are accessing Gregarius on http://example.com/gregarius/) add a new line:
RewriteBase /gregarius/
If this doesnt fix your problem you will have to do without the sexy url's. Go to http://example.com/gregarius/admin/index.php?domain=config and toggle rss.output.usemodrewrite to off.
[edit] Why do I get a 500 internal server error?
Again, this is probably a problem with mod_rewrite. Try the instructions above and if that doesn't work, then turn rss.output.usemodrewrite off and additionally delete the .htaccess file in your Gregarius directory.
[edit] Why do I get a "Bad request" error?
Once again, you guessed it, this is usually a problem with mod_rewrite and the .htaccess file. Usually this occurs when you try to access your gregarius installation via a URL like http://example.com/rss . The easy solution is to put a trailing slash at the end of the url so that it looks like http://example.com/rss/ . If you do not like trailing slashes, then you could try one of the two solutions below.
Try putting the line SetEnvIf Request_URI "/rss$" static in your .htaccess, right below all the other SetEnvIf lines.
If that doesn't work then there is another method if you have access to your apache configuration directory. You only have access to this directory if you are the administrator of the server hosting gregarius. Try adding the following lines to your configuration file
Alias /rss /pathto/gregarius/rss
RewriteRule /rss$ /rss/ [R=301]
<Directory "/pathto/gregarius/rss">
AllowOverride All
</Directory>
Remember to replace /pathto/gregarius with the actual path to gregarius on your server.
[edit] What happenned to the button that marks my feeds as read?
This is a new feature, introduced in Gregarius 0.5.0, that prevents non-administrators (e.g. everyone else but you) visiting your Gregarius site, from marking your precious items as read. Simply go to the admin area of your site by clicking on the admin button and then go back Home by clicking on the Home button. This will get your "Mark as Read" button back.
[edit] I cannot log into Gregarius any more. Help!?
If you have trouble logging in using the 0.5.4 or the svn version or you have simpy lost your password please use the Password Reset plugin to reset your password. You can find easy instructions on how to use the plugin inside the plugin itself.
[edit] Why do I get connection failed or timeout errors when adding or refreshing feeds?
Gregarius needs to have fsockopen enabled on port 80 to add and fetch feeds. To test fsockopen on your server, upload a test php file with the following to your server and look for an "OK" message when loading the page.
<?php
$fp = fsockopen("www.google.com", 80, $errno, $errstr, 30);
if (!$fp) {
echo "$errstr ($errno)<br />\n";
} else {
$out = "GET / HTTP/1.1\r\n";
$out .= "Host: www.google.com\r\n";
$out .= "Connection: Close\r\n\r\n";
fwrite($fp, $out);
while (!feof($fp)) {
echo fgets($fp, 128);
}
fclose($fp);
}
?>
[edit] Helping out
[edit] I would love to help Gregarius, where do I start?
We could really use your help in a couple of ways.
- The wiki needs editing in several places. Please feel free to correct any mistakes or add new documentation whenever you find anything lacking.
- Please report bugs that you find to help us keep Gregarius bug-free.
- If you are a graphics designer, we could use a really cool logo or some new themes.
- If you are a programmer and are running a development version of gregarius, you could help by submitting patches for bugs and adding functionality. Please join us on the gregarius-dev mailing list.
This isn't really a frequently asked question, but it is a frequently almost asked question, so it qualifies for this FAAQ.
