Difference between revisions of "FAQ amps"

From AMule Project FAQ
Jump to: navigation, search
(The addition is nice, but not in the README file :))
(Added Language Link, removed <pre> tags)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The FAQ for [[AMPS]] is well covered in two [http://forum.amule.org forum] threads and the ''README'' file packaged with the [[AMPS]] distribution (which I will copy verbatim here below):
+
<center>'''English''' | [[FAQ_amps-de|Deutsch]]</center>
  
[http://www.amule.org/amule/thread.php?sid=&postid=13729 AMPS signature images] - Some alternate base images for the [[signature]] image generated by [[AMPS]]. Some of these will probably be included in future [[AMPS]] revisions.
+
The FAQ for [[AMPS]] is well covered in three [http://forum.amule.org forum] threads and the ''README'' file packaged with the [[AMPS]] distribution (which I will copy verbatim here below):
 +
 
 +
[http://forum.amule.org/thread.php?threadid=2313 AMPS announcements] - Announcements about AMPS as well as a link to the package download
 +
 
 +
[http://www.amule.org/amule/thread.php?sid=&postid=13729 AMPS signature images] - Some alternate base images for the [[signature]] image generated by [[AMPS]]. Some of these will probably be included in future [[AMPS]] revisions.
  
 
[http://www.amule.org/amule/thread.php?threadid=2085 i18n info] - Information about translations and where to post if you have questions/comments/revisions regarding them.
 
[http://www.amule.org/amule/thread.php?threadid=2085 i18n info] - Information about translations and where to post if you have questions/comments/revisions regarding them.
  
 
'''From the [[AMPS]] ''README'' file:'''
 
'''From the [[AMPS]] ''README'' file:'''
<pre>
+
AMPS - AMule PHP Statistics
+
AMPS - AMule PHP Statistics
 
+
Copyright (c) 2004 Matt Britt <uberpenguin@hotpop.com>
+
Copyright (c) 2004-2005 Matt Britt <uberpenguin@hotpop.com>
Thanks to BigBob for writing the original aStats, which inspired this script
+
Thanks to BigBob for writing the original aStats, which inspired this script
 
+
To use AMPS, just copy this entire directory somewhere under your HTTP
+
To use AMPS, just copy this entire directory somewhere under your HTTP
server's document root. AMPS requires that your PHP binaries have been
+
server's document root. AMPS requires that your PHP binaries have been
compiled with GD and FreeType support (configure options '--with-gd[=DIR]
+
compiled with GD and FreeType support (configure options '--with-gd[=DIR]
--enable-gd-native-ttf'). Since AMPS has to access files outside the document
+
--enable-gd-native-ttf'). Since AMPS has to access files outside the document
root of your webserver (specifically the aMule signature file), the safe_mode
+
root of your webserver (specifically the aMule signature file), the safe_mode
option in your '/etc/php.ini' MUST be set to 'off'. If you want AMPS to display
+
option in your '/etc/php.ini' MUST be set to 'off'. If you want AMPS to display
in a different language, append '?lang=xx' to the 'index.php' file where 'xx' is
+
in a different language, append '?lang=xx' to the 'index.php' file where 'xx' is
the two-letter country code (assuming that translation exists) such as en, de,
+
the two-letter country code (assuming that translation exists) such as en, de,
fr, etc. If you input a country code the script does not recognize, it will
+
fr, etc. If you input a country code the script does not recognize, it will
simply default to en. Or you could just use the handy language selection drop-
+
simply default to en. Or you could just use the handy language selection drop-
down list at the bottom of the page!
+
down list at the bottom of the page!
 
+
AMPS looks for the aMule signature file (amulesig.dat) in /tmp. So make sure
+
AMPS looks for the aMule signature file (amulesig.dat) in /tmp. So make sure
amulesig.dat is actually being written to /tmp (the default is ~/.aMule).
+
amulesig.dat is actually being written to /tmp (the default is ~/.aMule).
 
+
If you would like to add a translation in your language, open the file 'en.inc'
+
If you would like to add a translation in your language, open the file 'en.inc'
in the 'langs/' directory, translate all the strings, and save the translated
+
in the 'langs/' directory, translate all the strings, and save the translated
file as 'xx.inc' where 'xx' is the two-leter language code (en, fr, etc). That's
+
file as 'xx.inc' where 'xx' is the two-leter language code (en, fr, etc). That's
it! Also, you probably will want to add the two-letter language code to the
+
it! Also, you probably will want to add the two-letter language code to the
array $completedlangs that is set near the top of 'index.php'. If you produce a
+
array $completedlangs that is set near the top of 'index.php'. If you produce a
translation, please be sure to send it to me for inclusion in the main
+
translation, please be sure to send it to me for inclusion in the main
distribution!
+
distribution!
 
+
Sometime in the near future I will complete the theme support I have stubbed
+
Sometime in the near future I will complete the theme support I have stubbed
into the script. If you have a colour scheme that you think looks good, modify
+
into the script. If you have a colour scheme that you think looks good, modify
'style.css' and be sure to send me a copy of your new syle so I can include it
+
'style.css' and be sure to send me a copy of your new syle so I can include it
in future versions!
+
in future versions!
 
+
Please send any bugs, translations, or verbal abuse to <uberpenguin@hotpop.com>
+
Please send any bugs, translations, or verbal abuse to <uberpenguin@hotpop.com>
 
+
Questions or comments regarding translations can be directed to the respective
+
Questions or comments regarding translations can be directed to the respective
translators listed in the CHANGELOG file.
+
translators listed in the CHANGELOG file.
</pre>
+
  
Additionally, ensure amulesig.dat is readable by your web server's PHP module by modifying the ownership/group or permissions of the file so that the webserver user has read permission.
+
Additionally, ensure ''amulesig.dat'' is readable by your web server's [http://www.php.org PHP] module by modifying the ownership/group or permissions of the file so that the webserver user has read permission.

Latest revision as of 09:21, 5 September 2007

English | Deutsch

The FAQ for AMPS is well covered in three forum threads and the README file packaged with the AMPS distribution (which I will copy verbatim here below):

AMPS announcements - Announcements about AMPS as well as a link to the package download

AMPS signature images - Some alternate base images for the signature image generated by AMPS. Some of these will probably be included in future AMPS revisions.

i18n info - Information about translations and where to post if you have questions/comments/revisions regarding them.

From the AMPS README file:

AMPS - AMule PHP Statistics

Copyright (c) 2004-2005 Matt Britt <uberpenguin@hotpop.com>
Thanks to BigBob for writing the original aStats, which inspired this script

To use AMPS, just copy this entire directory somewhere under your HTTP
server's document root. AMPS requires that your PHP binaries have been
compiled with GD and FreeType support (configure options '--with-gd[=DIR]
--enable-gd-native-ttf'). Since AMPS has to access files outside the document
root of your webserver (specifically the aMule signature file), the safe_mode
option in your '/etc/php.ini' MUST be set to 'off'. If you want AMPS to display
in a different language, append '?lang=xx' to the 'index.php' file where 'xx' is
the two-letter country code (assuming that translation exists) such as en, de,
fr, etc. If you input a country code the script does not recognize, it will
simply default to en. Or you could just use the handy language selection drop-
down list at the bottom of the page!

AMPS looks for the aMule signature file (amulesig.dat) in /tmp. So make sure
amulesig.dat is actually being written to /tmp (the default is ~/.aMule).

If you would like to add a translation in your language, open the file 'en.inc'
in the 'langs/' directory, translate all the strings, and save the translated
file as 'xx.inc' where 'xx' is the two-leter language code (en, fr, etc). That's
it! Also, you probably will want to add the two-letter language code to the
array $completedlangs that is set near the top of 'index.php'. If you produce a
translation, please be sure to send it to me for inclusion in the main
distribution!

Sometime in the near future I will complete the theme support I have stubbed
into the script. If you have a colour scheme that you think looks good, modify
'style.css' and be sure to send me a copy of your new syle so I can include it
in future versions!

Please send any bugs, translations, or verbal abuse to <uberpenguin@hotpop.com>

Questions or comments regarding translations can be directed to the respective
translators listed in the CHANGELOG file.

Additionally, ensure amulesig.dat is readable by your web server's PHP module by modifying the ownership/group or permissions of the file so that the webserver user has read permission.