forked from stan/asaph
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
122 lines (87 loc) · 4.76 KB
/
README
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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
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 <http://www.gnu.org/licenses/>.