WackoWiki: WackoDocumentation/WackoSetup ...

Home Page | Изменения | Новые Комменты | Пользователи | Каталог | Регистрация | Вход:  Пароль:  

1. Wacko Installation

Also available in Deutsch

Оглавление документа

Not much to it (as long as it works, ahem).

Check requirements
Unpack/upload the distribution files into a directory that can be accessed via the web.
Create an empty writeable file called wakka.config.php
Then go to the corresponding URL. A web-based installer will walk you through the rest.

1.1. Example

If your website, say, http://www.mysite.com, is mapped to the directory /home/jdoe/www/, and you place the Wacko distribution files into /home/jdoe/www/wacko/, you should go to http://www.mysite.com/wacko/.

Note that Wacko distributions normally unpack into directories that include the version in their name; you'll probably want to rename those to just “wakka” — or, if you're on a unixoid system, set up a symbolic link.

If you are upgrading or installing over a previously installed wacko wiki:

If you are installing to a clean directory

Wacko can export the Recent Changes list as RSS. Please make sure the xml/ subdirectory is writable, since this is where the files are stored.

IMPORTANT: for installing or upgrading Wakka/Wacko, do NOT modify any of the files contained in the setup/ subdirectory. They're used by the web-based installer/updater, but you should really just access the Wakka directory itself, and it will (or at least should) work perfectly.

(adapted slightly from Hendrik Mans original)

2. Wacko Update

Migration from WakkaWiki

Upgrade supported for WakkaWiki versions:

  • WakkaWiki 0.1
  • WakkaWiki 0.1.1
  • WakkaWiki 0.1.2
  • WakkaWiki 0.1.3-dev (R4.2)

  1. Backup all your important files including the files in the Wacko folder and in the database as well. You never know. Need a simple Backuptool?
  2. Extract the updated version of WackoWiki on to your hard disk.
  3. If you want to keep your layout, you have to use a program like WinMerge to merge your *.css and other theme files with the new files in the folder wacko/themes/default.
  4. (optional) You can create a file named locked in the wacko folder. This file should contain one line – this word will be the password. When Wacko finds this file, it will ask every visitor for a login/password, because of the upgrade process. The login name is “admin”, the password is the content of locked file.
  5. Now, upload the complete folder to your WackoWiki place. Let it replace the old files, if necessary.
    • However: wakka.config.php MUST be re-used from the old installation if you want to upgrade. Otherwise you will get database problems.
    • And: You MUST upload new files into the same directory if you want to upgrade.
  6. Navigate with your browser to the WackoWiki folder as you wanted to visit your page.
  7. If the data base needs updating, the installer will start automatically. It is self explanatory.
  8. Go to page and check the result! If you have any problems, you may have to adjust some *.css files.
  9. (see step 4) Do not forget to remove locked file.

If you see the blank page on any step,

  1. Open wakka.php and comment the line 8, «ob_start («ob_gzhandler»);", with an //.
  2. Then see DB error and report it to the bugtracker along with the steps to reproduce the problem.

Any problems with the install (that you want answered in English), paste below or in comments to this page.

Installing is very straightforward overall, however there are two things to look out for:
1. general: the unzipped directory and all contained files and subdirectories have (secure but not web-readable) permissions set so that the web-based installer is not found. The fastest way to get things running, but which also makes the install less secure is to go into the folder that contains the 'wacko' directory and run 'chmod -R 755 wacko'. Alternatively, go through all the directories and adjust permissions as necessary.
2. perhaps a problem on some webhosts: the .htaccess file gave my web host's configuration trouble, i.e. it couldn't find anything within the wacko folders. deleting .htaccess solved the problem.

3. What should my .htaccess file look like in order to allow for “nice-looking” URL's? I attempted to use the same rules as I previously used (successfully) on WakkaWiki, but no luck. The way I attempted it, my .htaccess file looked like this:

RewriteEngine on
RewriteRule ^style/logo/r=(.*)/g=(.*)/b=(.*)/(.*)$ style/betapilogo.php?r=$1&g;=$2&b;=$3 [QSA,L]
RewriteRule ^style/logo/grey=(.*)/(.*)$ style/betapilogo.php?grey=$1 [QSA,L]
RewriteRule ^style/(.*)$ style/$1 [L]
RewriteRule ^style$ wakka.php?wakka= [L]
RewriteRule ^(.*)$ wakka.php?wakka=$1 [QSA,L]

Anyone see what I'm doing wrong?

3. RomanIvanov: Please, take .htaccess from Wacko distro.

3. Questions

3.1. How can access to all files be limited to known wacko users?

It would be great not to have to restrict but the problem is that some fool keep publishing links to porn on our wiki!!!
Thanks for a great job otherwise! Phil

The answer is in the wiki already See Access Control Lists found it myself after a little more reading

3.2. 404 Not Found – Wiki cannot be found

after installation without errors -> wrong settings for rewrite_mode

I've tried an install on localhost — no problem — then tried two on an ISP (Win) and have no success; after installation which says all was OK; when I click on the homepage — I get an error page — The page cannot be found — and .net/wacko/index.phpHomePage...??? Thanks for your help.

Not Found

The requested URL /wacko/StartSeite was not found on this server.

you set your Base URL without /wakka.php?wakka=

go in your wakka.config.php and add /wakka.php?wakka= to your Base URL

�rewrite_mode� => �0�
�base_url� => "http://... /wakka.php?wakka="

now it should work (?)
Yes — that fixed it. Thanks.

I was having the same problem and changed my Apache configuration so the directory declaration looks like this:

Rewrite seems to work fine now.

3.3. Strange Add Page Behaviour

On one of my sites, the Wiki can't seem to stop adding pages — after you click Maybe you want to create it? , and add text — then SAVE, it adds another page — with... Racing/Argentina/editadd1?v=1ekf after the entry — it also forgets the entries it has already made. I'm confused because my other sites work very well. Also, it wont allow you to logout....or register?

Solution: in config file do: �rewrite_mode� => �0�

3.4. Email problem

i do not have an smtp server running on my website, and no mail is being sent. how can i change the used smtp server? and do you know of any open smtp servers which i could use?
I have the same problem, where do I define what server to send mail through for watchlists? – RossFi

mail() function

3.5. Login problem

I can't logi or logout. Noting happened whe I push logout.
Firefox 1.0.6 Konqueror Opera etc. Linux Mandriva 2006.

Файлов нет. [Показать файлы/форму]
Комментарии [Скрыть комментарии/форму]

Note that any files uploaded using the technique in R3 will no longer appear on their respective pages. The good news, however, is that the files are still there, as I just found out. Слава богу.

-- adsl- (2004-07-21 07:28:22)

I want to set up Wacko Wiki with UTF-8 build-in support(because of my native language is a multi-byte language), here are what I do:

But I got no luck. Though editing a page the text(in multi-byte) is fine, while viewing a page it's not.

What any extra configuration should I pay attention to to enable UTF-8 support? Thank you.

-- csc0g01prb.net.cuhk.edu.hk (2004-11-19 04:29:37)

No UTF-8 support will be in Wacko till the wide spread of Mysql 4.1.

-- RomanIvanov (2004-11-21 20:10:12)

Hi. The setup page send me this message:
Testing Configuration
Testing My SQL? connection settings... FAILED
The database and user are created correctly. I don't know what is missing ...
Could you help me ?

-- (2005-01-18 22:11:35)

> Hi. The setup page send me this message:

Hellooy :-) Can you please resubmit this request to the wacko-bugtracker:

2 Роман, а может такие запросы из комментариев сразу жестко туда переносить? :-) Чтобы борода экспромт-багрепортов не росла

-- SlipStream (2005-01-25 14:53:44)
А как их туда переносить, если нету главного — обратной связи с автором реквеста?
-- RomanIvanov (2005-01-25 15:28:11)
А если так и переносить, от своего имени � "аноним с неким ip сообщил нам, что у него []", и тут же закрыть как недостаточно точно сформулированное? Главное, что комментарий после этого удалить можно, и заодно ссылаться на такой недо-запрос удобно :-)
-- SlipStream (2005-01-25 21:17:41)

Странное дело, на хосте провайдера сетуп проходит на ура, но вот на локальной машине где никогда проблем с SQL, php, modrewrite не было пишется постоянно это – Testing Configuration
Testing My SQL? connection settings... FAILED
На удаленной машине я уже с закрытыми глазами все делаю... но локально. Локально под windows... никак. Проверьте у себя.

-- ppp83-237-56-60.pppoe.mtu-net.ru (2005-02-09 00:32:29)

Добрый день!
Я установил у себя на сервере wacko wiki,при установке следовал инструкции, никаких ошибок не было.httpd.conf редактировал руками. URL у Wacko Wiki wacko.domai.ru. Когда пытаюсь зайти в вики у меня появляется Стартовая страница, но она какая-то недоделанная. Такое ощущение что не применяются темы к уже существующему HTML тексту, нет ни одной картинки. В директории где лежит сам Wiki права даны пользователю от которого запускается apache. Где я могу получить помошь по моему вопросу? Спасибо

-- tech.in.devexperts.com (2005-04-28 12:56:14)

Have any problems with .htaccess? I added this line into the file and it started working:

Rewrite Base? /wacko/

-- zk78.internetdsl.tpnet.pl (2005-05-22 10:20:46)

Testing My SQL? connection settings... FAILED

-- ip68-110-202-97.ri.ri.cox.net (2005-10-18 01:59:50)

I've got problem with installing R4.2 – the installer is unable to create a table “links”. It returns an error “Creating link tracking table... FAILED: Already exists?”. Of course it doesn't exist already; it's an empty database. All other tables are being created without problems exept this one.

When trying to display my home page (.../wiki/) I am returned to intaller. When trying to display home page (.../wiki/HomePage) I get this error «Query failed: select * from 01_links where from_tag='HomePage' (1146: Table 'wikki.01_links' doesn't exist)"

My dev machine: Windows XP SP2 PL, My SQL? 4.1.7, Apache / 1?.3.33 (Win 32?), PHP 4.4.0

-- c27-67.icpnet.pl (2005-10-24 13:10:10)

link tracking – ERROR
My Sql? 4.1 Compatibility only with DB locale Latin-1; no UTF8!

-- SkipPer (2005-10-24 21:18:45)

There is a problem witch Polish installation. After successful installation I was unable to login as administrator or logout if I created other account.
The problem is caused by missing �wakka.pl.php� file in the /themes/[theme name]/lang/ directory
To fix this problem I was forced to create missing file by copying to this directory �wakka.en.php� with new name �wakka.pl.php�.
I believe the missing file �wakka.pl.php� do not exist in installation package.
Please correct this. This simple error is a big issue for inexperienced users without php knowledge. This error exist since first R4.0 version of Wacko Wiki

Sorry for my English, still broken ;)

-- 70-32-2-91.frdrmd.adelphia.net (2005-12-23 06:34:59)

to MDD:
pls. contribute these files in Polish and put it in the bugtracker: http://www.npj.ru/bugs or / and send it to Roman. I'm afraid if no one does it will never be done. ;)

-- SkipPer (2005-12-23 09:10:32)

The same problem.

I can't login in header form too!

When I coppied �wakka.en.php� file to the /themes/[theme name]/lang/ directory as 'wakka.pl.php' nothing changed in my instalation.

But in my instalation I could log in under page http://wackowikisite/Login.

-- w1.lomza.rta25.4lan.pl (2006-01-15 17:00:03)

Last comment: PiotrGryko /15.01.2006 17:03/

-- PiotrGryko (2006-01-15 17:03:25)

Another Polish problem at THIS site.

I registered and set preferred language as Polish. My header becomes to be like that:
Home Page | Index Stron | Ostatnie Zmiany? | Ostatnio Komentowane? | U�ytkownicy? | Rejestracja? | + | Piotr Gryko ( Ustawienia | Wyloguj )
...and I can't change it anyway.

Index Stron -> Page Index
Ostatnie Zmiany -> Last Changes
Ostatnio Komentowane -> Last Comments
U�ytkownicy -> Users
Rejestracja -> Registrations
Ustawienia -> Settings
Wyloguj -> Logout

-- PiotrGryko (2006-01-15 17:08:40)


after changing “Language” in “Settings” list in Your QuickLinks: doesn't change. Header stays as I wrote last time.

-- PiotrGryko (2006-01-15 17:13:23)

did you use this file

dont mix up with language files from themes, pls. compare


and wich theme?

-- SkipPer (2006-01-16 01:34:49)

....it was standard instalation and standard theme («default» – I suppose)

...could you tell me, how can I compare all files in folder quickly...
... I didn't work with CVS to this day :) ... (few words? ...or link?)... I havn't access to linux\unix bash (command line and so on)... only ftp to push my files to server, and my PC with MSWinXP .

With simple edit method it looks like the same files.

And my last posts concerned to THISsite -> I mean: http://wackowiki.com/

«Another Polish problem at THIS site. [....] "

-- PiotrGryko (2006-01-16 02:33:41)

I'm running Apache 2.2.4 and PHP 5.2.1 on Source Mage?. Even after running 'chmod -R 0777 /www/*', I get an error message about permission problems. When I reload that page, I receive the following error:

Catchable fatal error: Object of class Wacko could not be converted to string in /www/recipes/wakka.php on line 254

Any ideas?

(Можно ответить по-русски, если предпочитаешь)

-- PovarPaul? (2007-04-29 23:09:30)
PHP 5.2 ISSUE, this is a new error introduced in PHP 5.2 (http://us3.php.net/types.string)

may be someone will offer an patch

if possible choose an earlier php version
-- SkipPer (2007-04-30 04:53:48)
Время работы: 2.519 s
Использовано памяти: 1.676 Mb