MaxWiki Web Site

Forms

Wed, 14 May 2008 18:01:48 Z

Forms

Email Subject

The subject line in the email that is sent from the form will use the value from the hidden field that contains "form_name" in it. It is okay to have a number before it like "000 form_name" but it needs to be in lowercase.

The volunteer application is already setup to do this, and in source mode it looks like:

<input type="hidden" value="Volunteer Application" name="000 form_name" />

In WYSIWYG mode, the hidden field will appear as a box around the letters "ab". You can right click on this and choose "Hidden Field Properties" to change the Name to "000 form_name" and the the Value to what you want to appear in the subject.

Left Menu

Mon, 28 Apr 2008 22:01:41 Z

Left Menu

MaxWiki can use dynamic left menus that highlight the menu item corresponding to the current page (like the one on this page).

To use a left menu, simply add a bullet list with class="left_menu". The source will look like:

 <ul  class="left_menu">
    <li class="submenu"><a href="/About Us">About Us</a></li>
    <li><a href="/Team">Team</a></li>
    <li><a href="/Contact">Contact</a></li>
</ul>

Note that after creating the list, you will need to add class="left_menu" to the ul tag and add class="submenu" to the first li item.

Advanced Matching

Normally, the menu item corresponding to the page name is selected. However, suppose you have a dog rescue site and want to show the many dogs you have successfully placed in homes. At first, this might all fit on one page but over time, you have arranged adoptions for so many dogs that you want to separate the list onto several pages. Maybe the pages are:

Adopted
Adopted 1
Adopted 2

Normally the left menu item "Adopted" would only be selected for the "Adopted" page and not "Adopted 1" or "Adopted 2". To get around this, add an ID to the menu item link by right-clicking on it and selecting Edit Link -> Advanced -> Id and typing "adopted". This is a case insensitive regular expression that will be used to match against the page names. So now, whenever any of the Adopted pages is shown, the Adopted menu item will be selected.

Install

Sat, 12 Apr 2008 01:07:45 Z

MaxWiki Install

Here are detailed instruction on installing MaxWiki and its supporting environment on Linux. Even though the samples below are for RedHat, they should also work on most other Linux distributions with a little tweaking. For Windows and Mac, follow the alternate instructions for setting up Ruby/Gems/Rails then continue with the MySQL section.

Ruby

Download and install Ruby 1.86

(From: RubyOnRails Download)

Gems

Download RubyGems
Extract then run: ruby setup.rb

(From: RubyOnRails Download)

Rails

Run: gem install rails --include-dependencies

(From: RubyOnRails Download)

MySQL

Install MySQL5
Create database and user and assign rights:
mysql -u root -p
create database maxwiki;
create database maxwiki_test;
grant all on maxwiki.* to rails@localhost identified by 'password';
grant all on maxwiki_test.* to rails@localhost;

Install MaxWiki

Create and goto MaxWiki directory: /usr/local/rails/maxwiki
Checkout from svn:
svn checkout svn://rubyforge.org/var/svn/maxwiki/trunk .
For enterprise customers, get the additional plugins (username and password needed):
cd /usr/local/rails/maxwiki/vendor/plugins
svn checkout http://svn.maxwiki.com/svn/maxwiki_ent/plugins/maxwiki_multihost
svn checkout http://svn.maxwiki.com/svn/maxwiki_ent/plugins/maxwiki_convert
svn checkout http://svn.maxwiki.com/svn/maxwiki_ent/plugins/maxwiki_webdav
svn checkout http://svn.maxwiki.com/svn/maxwiki_ent/plugins/maxwiki_webdav_auth
Also for enterprise customers, get the files for your site (username and password needed):
cd /usr/local/rails/maxwiki/public/files
svn checkout http://svn.maxwiki.com/svn/maxwiki_ent/files/your_site_name

Rails User

Create group: groupadd rails
Create user:
useradd -c “Rails Server” -g rails rails
passwd rails
Change owner of rails files: chown -R rails:rails /usr/local/rails

Setup MaxWiki

For the following files, copy the file to a new file without the .template extension, then customize. For instance, copy database.yml.template to database.yml.

config/database.yml
config/local_environment.rb

local_environment.rb

If you are running the Enterprise multi-host, change the top of this file to something like:

MY_CONFIG[:host_map] = [
   {:host => 'www.maxwiki.com', :name => 'maxwiki'},   
   {:host => 'maxwiki.com', :redirect_to => 'www.maxwiki.com'},   
]

Database Setup

To setup the database tables run: rake db:migrate

Install Mongrel

Install Mongrel: gem install mongrel mongrel_cluster --include-dependencies

Test

At this point, it is a good idea to test MaxWiki with Mongrel (and no Apache).

Start Mongrel with: mongrel_rails start
Access your server at port 3000. For instance, if installing locally use: http://localhost:3000
Fill in the MaxWiki setup screen fields and save.

If you are setting up a development system, you can stop here. The following sections are for production servers.

Single Mongrel

For many installations, a singe mongrel instance under Apache will work fine (and is much easier to configure). Follow the instructions below, but change the RewriteRule line to:

  RewriteRule .* http://127.0.0.1:8000%{REQUEST_URI} [L,P,QSA]

And start Mongrel with:

  mongrel_rails start -d -p 8000 -e production -P /full/path/to/log/mongrel-1.pid

(From: Apache Best Practice Deployment)

Mongrel Cluster

For installations where it will be getting many simultaneous hits, setting up a mongrel cluster is required for best performance.

In Rails home: /usr/local/rails/maxwiki
Add file: conf/mongrel_cluster.yml
---
cwd: /usr/local/rails/maxwiki
port: "8000"
environment: production
address: 127.0.0.1
pid_file: log/mongrel.pid
servers: 3
user: rails
group: rails
Add Mongrel as a system service:

cd /etc/init.d
sudo ln -s /usr/local/lib/ruby/gems/1.8/gems/mongrel_cluster-0.2.1/resources/mongrel_cluster mongrel_cluster
sudo chmod +x mongrel_cluster
sudo /sbin/chkconfig --level 345 mongrel_cluster on
sudo mkdir /etc/mongrel_cluster
sudo ln -s /usr/local/rails/maxwiki/config/mongrel_cluster.yml /etc/mongrel_cluster/maxwiki.yml

(From: Time For A Grown Up Server)

Apache mod_proxy

We need to add mod_proxy support to Apache 2.2 since the default doesn't include it.

Download and expand Apache proxy module source:
cd /usr/local/src
wget http://apache.mirror.positive-internet.com/httpd/httpd-2.2.3.tar.gz
tar –xzvf httpd-2.2.3.tar.gz
Add proxy modules to apache:
/usr/local/apache2/bin/apxs -i -a -c mod_proxy.c proxy_util.c
/usr/local/apache2/bin/apxs -i -a -c mod_proxy_balancer.c
/usr/local/apache2/bin/apxs -i -a -c mod_proxy_http.c

(From: Apache 2.2 + mod_proxy_balancer)

Apache Virtual Server

Change to Apache directory: cd /usr/local/apache2
At bottom of: conf/httpd.conf
NameVirtualHost *:80
NameVirtualHost *:443
Include conf.d/*.conf
Create file: conf.d/1_maxwiki.conf
<VirtualHost *:80>
# This should remain the first virtual host because it will service all hosts
# that are not explicitly defined in other VirtualHost sections
# Also, we don't need to define any ServerName or ServerAlias
DocumentRoot /usr/local/rails/maxwiki/public
<Directory "/usr/local/rails/maxwiki/public">
    Options FollowSymLinks
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

# this not only blocks access to .svn directories, but makes it appear
# as though they aren't even there, not just that they are forbidden
<DirectoryMatch "^/.*/\.svn/">
    ErrorDocument 403 /404.html
    Order allow,deny
    Deny from all
    Satisfy All
</DirectoryMatch>

# Rewrite to check for Rails cached page
# Also for caching, take out :80 if present, and change : to _
RewriteEngine On
RewriteRule ^/$ /cache/%{HTTP_HOST}/index.html [QSA]
RewriteRule ^/([^.]+)$ /cache/%{HTTP_HOST}/$1.html [QSA]
RewriteRule ^(.*):80(.*)$ $1$2 [QSA]
RewriteRule ^(.*):(.*)$ $1_$2 [QSA]

# Redirect all non-static requests to cluster
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ balancer://mongrel_cluster_maxwiki%{REQUEST_URI} [P,QSA,L]
</VirtualHost>

<Proxy balancer://mongrel_cluster_maxwiki>
BalancerMember http://127.0.0.1:8000
BalancerMember http://127.0.0.1:8001
BalancerMember http://127.0.0.1:8002
</Proxy>
Restart http:
- Check syntax: bin/apachectl -t
- Restart: bin/apachectl restart

Update Instructions

Update the main MaxWiki files. In the MaxWiki Rails root directory:
svn update
Update the site specific files (if you have Multi-Host). In /RAILS_ROOT/public/files/mysite directory:
svn update
Update the database: Back in the MaxWiki Rail root directory:
rake db:migrate
Restart Mongrel:
mongrel_cluster_ctl restart

Google Webmaster Tools

Fri, 04 Apr 2008 18:03:53 Z

MaxWiki allows you to send a RSS feed to Google so that your site will be indexed. Here are the steps to do this:

Signup for a Google Webmasters Tools account
Add your site
Select Verify -> Add a meta tag
Copy (Ctrl-C) the content string. That is, if it shows: <meta name="verify-v1" content="xyzzy" />
The content string is: xyzzy
Go to your MaxWiki site, Admin -> Configuration -> Main
In the “Google Sitemap Verification” field, paste (Ctrl-V) the content string and select the Update button
Then expire the cache using Admin -> Configuration -> Expire Cache
Go back to Google Webmasters Tools and click “Verify”
After it has verified correctly, click on Sitemaps -> Add a Sitemap -> Add General Web Sitemap
Enter “rss_with_headlines?limit=0”

That is it! Now Google will have a sitemap of your MaxWiki site and this will help Google index it.

Google Analytics

Mon, 31 Mar 2008 15:45:49 Z

MaxWiki is already setup to use Google Analytics. All that needs to be done is:

Go to Admin -> Configuration -> Main -> Google Analytics Account and enter the account number
Expire the cache Admin -> Expire Cache

Now all of your pages will have the Google Analytics code and will be tracked.

Blogs

Fri, 28 Mar 2008 14:12:18 Z

Blogs

Blogs are a little different from regular pages in that each blog "post" is a separate page and then all the posts are shown on the main blog page.

To create a blog page, put [ %= blog % ] on it.

Then create individual pages for each post, selecting "Add title to page? - Blog" and the page name as the Parent Page.

Test

Fri, 16 Nov 2007 21:29:50 Z

Test Page

Heading 2

line 3

The Clinton Crack-Up: The Boy President's Life After the White House
by R. Emmett Tyrrell

Mailing List Manager Requirements

Wed, 14 Nov 2007 23:34:27 Z

Mailing List Manager Requirements

Requirements

Multiple mailing lists
Each mailing list may have a different manager
Interface to signup and cancel
Add links to emails to opt-out
Automatically add members
Send to a subset of the entire list (e.g. users who haven't paid)
Send a message to users who haven't received the message before (e.g. thanks for paying)
Ability to add any email address to the list (i.e. someone who is not signed up for MaxWiki or Google)

Google Groups

Does #1, #2, #4, #8
While it does do #3 on its own, this is not integrated with MaxWiki. Maybe add some Subscribe buttons to the My Accounts page
#5 could probably be done through POST (but it might also need screen scraping since the form appears to be protected by a nonce).
#6 might be do-able by exporting the list, matching to internal members, applying the filter, and then sending out internally, mimicing the look of the Google Group email. Could also handle by just sending out directly, but then there wouldn't be any opt-out capability. However, then it wouldn't be archived in the Google Group.
#7 might be handled by just sending the message directly.

MaxWiki Mailing List

Does #1, #5, #6 and #7
For #2, need to add a list of managers for each mailing list and easier way to send emails
For #3, could add this to the My Account page
Need to figure out how to handle #8

Conclusion

Use both Google Groups and the MaxWiki mailing list. Google Groups will be the main way we communicate, and we will setup different lists for general, board, managers, teams, etc, while the MaxWiki mailing list will be used for #6 and #7, when we need to mail to a subset of the entire list.

To make it easier to use Google Groups, we will try to implement buttons on the TriCities site so users can more easily signup to the appropriate Google Group (#3), and also try to automatically add users to the general Google Groups list (#5).

Sample Themes

Fri, 09 Nov 2007 01:18:21 Z

Sample Themes

Apple

Vine and Dine

Little League

PBCCKids

Ruby on Rails Camp

ChangeLog

Thu, 08 Nov 2007 22:00:57 Z

Change Log

November 8, 2007 (SVN 736)

Change format of Amazon drag-and-drop to a small image that floats left. Also cleaned up some other drag-and-drop issues.

November 8, 2007 (SVN 735)

Updated to Scriptaculous 1.8 and Prototype 1.6. This fixed a recursion problem with media drag-and-drop.

November 8, 2007 (SVN 733)

Fixed a bug in FCKEditor 2.5beta that would pop-up a security paste dialog when trying to drag-and-drop from the File Upload plugin

November 7, 2007 (SVN 731)

Added the Insert/Edit Image icon in the editor toolbar
Took out the paste from Word icon in the editor toolbar

November 6, 2007 (SVN 730)

Update FCKEditor to version 2.5beta which supports Safari and Opera
Added a page browser and fixed uploads in FCKEditor

October 26, 2007 (SVN 728)

Allows comma delimited lists of email address in the configuration "Signups CC" field so signup notifications can go to more than one email address
Email forms now use the email address in "Signup CC" rather than "Emails From"
Email forms can have a hidden field "email_to" and the form will be emailed to those email addresses.
The "email_to" domain must be the same as the domain of an address in "Signups CC" or "Emails From" for security reasons.
Note: if using three or more emails in the "email_to" field, separate them with commas and no space like this: "mail1@test.com,mail2@test.com,mail3@test.com"

October 19, 2007 (SVN 723)

Enhanced file uploads to use Ajax so it stays in edit window during the upload
Misc other file upload enhancement

October 19, 2007 (SVN 722)

Allow alternate syntax for ERB commands using square brackets [% %] so they are visible in normal edit window
Fixed SQL problems in WikiReference that would sometimes produce an exception when looking at a page revision
Took out category code that wasn't being used
Took out wiki param to WikiReference.link_type and using current_wiki instead

October 11, 2007 (SVN 718)

Patched a security hole with file uploads
Enhanced file uploads so that the upload directory can be specified in local_environment.rb and doesn't need to be in separate directories for each page
When dragging a picture onto the page, it now is shown full size rather than being constrained to 50 pixels

October 10, 2007 (SVN 717)

Orphan list is now correct - it only shows pages that can't be reached from the main pages. However for existing sites, it is necessary to convert left_menu to list format (SVN 711) and save any existing _menu or _left pages in order for the orphan list to be updated correctly.

October 10, 2007 (SVN 716)

Enhanced left_menu so that if a link has an ID, then that will be used in a regular expression for selecting the menu item. For instance, if there is a menu item "Adopted" and page names "Adopted", "Adopted 1", "Adopted 2", then by setting the ID of the menu item to "adopted" (case insensitive) then when any of these pages is shown, the "Adopted" menu item will be selected.

October 9, 2007 (SVN 715)

Navigation now has separate menu items for All Pages, Orphans and Wanted, and the latter two only appear when the user has at least an Editor role. This makes the All Pages page more suitable for a site-map.

October 8, 2007 (SVN 712)

Added support for an icon to appear in the browser address bar (favicon). To use this feature place in the site directory (i.e.: /files/maxwiki") a "favicon.ico", "favicon.gif", or a "favicon.png" image (the latter two should be sized 16x16).

October 8, 2007 (SVN 711)

When saving a page, href or src links that start with "../../" will have this deleted. This is necessary for file uploads on and sometimes when copying-and-pasting HTML.
ERB method "left_menu" now deprecated, use list with class "left_menu" instead.
Refactored Revision display_content and update_references.
Fixed bug that sometimes caused includes to be rendered in Revision and sometimes through the ERB helper.
Added current_wiki.current_page_name that gets set to the main page name that is being processed so Revision knows this when processing left_menu lists to select the correct list item

Instead of:

< %= left_menu 'About Us', 'Team', 'Contact' % >

Build a list whose source looks like:



    <li class="submenu"><a href="/About Us">About Us</a></li>
    <li><a href="/Team">Team</a></li>
    <li><a href="/Contact">Contact</a></li>
</ul>

Note that after creating the list, you will need to add class="left_menu" to the ul tag and add class="submenu" to the first li item.

October 5, 2007

Enhanced the "All Pages" page (/_action/wiki/list) to not show the _left, _right and _menu pages

October 4, 2007

The FCK link editor now puts in a slash '/' in front of the page name
Updated the FCK link editor dialog to show "MaxWiki Page" rather than just "Wiki"
Changed the FCK stylesheet to main.css so the styles in the editor window will look better (regression)
Added MY_CONFIG[:hide_byline_author_link] config param so author info in the byline will not appear as page links

October 3, 2007

Any text on the page that looks like an email link will be converted to an encoded mailto link to protect against spam harvesters
Existing mailto links will not be converted

Test_Form

Tue, 30 Oct 2007 17:24:49 Z

Test Form

Editing Emails

Sat, 20 Oct 2007 16:36:46 Z

Email Addresses

In order to fool the “spam bots” that look on web sites for email addresses, MaxWiki automatically detects email addresses on a page and encodes them. However, if it doesn't recognize the email address (usually because there are characters before or after it), you can encode the email manually by going into Source mode and using:

<%= email('info@maxiwiki.com') %>

This produces a link like this: <%= email('info@maxiwiki.com') %>

This link works fine, but it is encoded to fool the spam bots.

Products

Wed, 03 Oct 2007 23:34:12 Z

Our Products and Services

OpenMaxWiki

OpenMaxWiki is a RoR based wiki that MaxWiki Software has created and submitted to the open source community for use, critique, and enhancement. MaxWiki is a cross between a content management system and a wiki. It has wiki style edit links on every page, but it looks like a real web site and can be skinned for a different look-and-feel. In addition, Rails components can be included on any wiki page so that a page can include things like a registrant list, event scheduler, Google map, etc, in addition to normal wiki text. It also includes advanced page caching that works with all roles.

The code bundle is available from RubyForge:

OpenMaxWiki

This free version of MaxWiki is supported through the open source community. And, of course, that includes MaxWiki Software. If you run across something we should know about (good or not so good), please send us an email at <%= email 'info@maxwiki.com' %>. If we can, we’ll respond (because we’re “pedal to the metal” right now building in new features for Version 2.0 of our commercial offering due for release in Spring 2007, we might not get back to you immediately).

EnterpriseMaxWiki

Building on its’ open source counterpart, EnterpriseMaxWiki offers enhanced features for integrating into commercial infrastructures. Designed to support a plug-in architecture, EnterpriseMaxWiki, includes plug-ins (Rails components) for YouTube, Flickr, DaveTV, Amazon, iTunes, and the Xythos Enterprise Document Manager. In particular, the current version of EnterpriseMaxWiki supports dynamic linking to office type documents stored on PC file systems and the Xythos Enterprise Document Manager application.

Using webDAV as the open-standards based, linking protocol, EnterpriseMaxWiki allows content authors the flexibility to create content using familiar tools like MS Word, Powerpoint and Excel, then publish to EnterpriseMaxWiki. Changes made to the source documents are automatically reflected on the published web-page.

Standard technical support is available during normal business hours.

Services

MaxWiki Software Professional Services offers the following:

Implementation Services
Customization Services including:
- AD / LDAP integration
- Portlet building and integration
- Template Design and Building
Training
RoR Application Building

Contact Us

Wed, 03 Oct 2007 23:23:31 Z

Contact Us

Stay tuned! We’re moving into our new offices soon.

In the meantime…

For information about MaxWiki products and services:

email: <%= email 'sales@MaxWiki.com' %>

or call: 1.408.569.9185

Drag-and-Drop Results

Tue, 02 Oct 2007 22:23:17 Z

Drag-and-Drop Results

	Flickr Drag	Flickr Dbl-Click	File Drag	File Dbl-Click
FireFox: WYSIWYG (Mac)	Flaky⁵	Yes²	Yes^{1, 3,4}	No
Safari: Textile	Flaky^5,6	No	Yes^1,6	No

Notes:

When dragging you can move the cursor position to where you want to place it
Always places it at the end of the text
The placed image is small, and you need to resize it for true size
The resulting link prepends ../..
The first one works, subsequent ones do an image drag-and-drop like 1,2
Places a link to the image, not the image itself

Your information
Name:
Address: