Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jgthms/asaph

A micro-blogging system, focusing on collecting links and images
https://github.com/jgthms/asaph

Last synced: 3 months ago
JSON representation

A micro-blogging system, focusing on collecting links and images

Awesome Lists containing this project

README 

        
Asaph version 1.0 



Author: Dominic Szablewski

Web: http://www.phoboslab.org/projects/asaph



Requirements & Installation

-------------------------------------------------------------------------



Asaph needs PHP 5.0 or higher with the GD-lib installed and cURL or

allow_url_fopen enabled. Also MySQL 4.0 or higher and an already created

database is needed. To post entries to your blog, you'll need a good

browser (read: anything not Internet Explorer).



To install, enter your database and server settings in the

lib/asaph_config.class.php file. The settings you absolutely need to 

change are $domain, $absolutePath and $db. You also have the option to 

switch from the minimalist whiteout templates to the stickney templates 

by just replacing both occurrences of "whiteout" with "stickney" in the 

$templates setting.



When done, upload all files to your server and make sure the data/

directory is writable - this is where Asaph stores all images and 

thumbnails. After that, point your browser to admin/install.php and 

follow the instructions.



Usage / Posting

-------------------------------------------------------------------------



The only way to post new entries to your Asaph blog, is through a 

bookmarklet. After logging in to your admin menu, you will see the ASAPH

bookmarklet on the left. Just drag this link to your bookmarks bar and

you're set. 



Now, navigate your browser to any page you want and click your newly 

created bookmark. A small box should pop up and all images on the page

should now have a dashed blue border (if not, see the FAQ). You can now 

either click on any of these images or on "Post this Site" to post the

image or link.



FAQ

-------------------------------------------------------------------------



Q: My bookmarklet is not working

A: This can have several reasons. The most common one is, that your

   $domain and/or $absolutePath setting is not correctly set in the 

   asaph_config.class.php. Refer to the installer (admin/install.php) it 

   should tell you the correct settings for these values in the 

   "Asaph Config" section.

   Another reason for the bookmarklet not working could be, that you

   disabled iframes in your browser. Some ad-block plugins do this.



Q: When posting images I repeatedly get the message "Couldn't create a 

   thumbnail of the image!"

A: Most of the time this happens because Asaph wrongly detects the image 

   URL. Maybe because the thumbnail is linked to an interstitial instead of 

   the image itself. You can enter the image URL manually into the "Image" 

   field if Asaph fails to detect it.

   

Q: I'm getting the error message "parse error, unexpected ',', expecting 

   '(' in /admin/install.php on line 46" when I try to install Asaph.

A: Your server is not running PHP5 (see requirements). Ask Your hoster to

   update.



Thanks

-------------------------------------------------------------------------



Thanks to Nicolas Magnier (www.gamovr.com), Nate Cook (natecook.com) for

some code contributions and countless others for all the helpful comments,

bug reports and suggestions.



Changelog

-------------------------------------------------------------------------



Version 1.0

  - Added more comments to source files, to allow easier modification

  - New $title config variable used in templates

  - Various bugfixes in the RSS template

  - Fixed bug, where changing the post date would not create a new 

    directory in data/

  - Fixed bug, where deleting a post would not delete the image from disk

  - Fixed bug, where the user was being redirected to a malformed URL on

    success (xhrLocation in remote-success.html.php)

  - New template theme "stickney"

  

Beta 2

  - Usage of cURL or url fopen wrappers, based on what's available

  - magic_quotes are now reverted automatically

  - The RSS Feed should now display images properly

  - Fixed bug, where post titles were filtered through htmlspecialchars 

    twice when editing post in the admin menu



License

-------------------------------------------------------------------------



Copyright (C) 2008  Dominic Szablewski



License: http://www.gnu.org/copyleft/gpl.html



This program is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.



This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.



You should have received a copy of the GNU General Public License

along with this program.  If not, see .