=====Tools To Use Wiki As a Pim=====
{{lastedit show="3"}}
One use of Wikka is as a Personal Information Manager. For some things the free-form writing nature of a wiki is useful (and, dare-I-say, liberating). However, as some of our usage at this site suggests, there are tools that can be developed AS actions in wikka that can make some aspects of information management a bit easier. In the past six months I've modified/developed two tools (with more forthcoming) with this purpose. One tool is a collection of actions so that schedules can be kept and organized on line. Its components include a "rapid entry" tool (##scheduler.php##, which should be kept on a page called ""ScheDuler""), a monthly schedule view (##monthschedule.php## which should be kept on a page called ""MonthSchedule"") and a day view (##dayview.php## which should be kept on a page called ""DaySchedule""). These actions depend on a function which must be included as a file in the ##scripts## directory. A year-view calendar is also available at GmBowenCalendar.
The other available action is a task manager (based on gbtask). The badwordfunction is at the bottom of the page (and currently is needed by the task manager & must be included in wikka.php).
=====Scheduler=====
Scheduler is an action which allows a person to keep a day calendar (or diary for that matter). Although the entry formatting is simple, at the same time it provides flexibility. A user can enter a day schedule.....
8:00 am - meeting with joe
9:00 am - coffee with angie
10:00 am - clients from budapest
or use it to keep a to-do list, or even a diary for the day. The schedule for a day can be viewed with the entry tool, in the monthly view, or in the day view. The day viewer is formatted for printing out usable schedules, & you can designate a specific user with it and see somebody else's schedule (I intend on modifying this so that there will be an easy-to-use text entry box for entering user names).
http://gmbtst.msvu.ca/wikitest/scheduler.jpg
Code for table in data base.....
~&**Make sure you replace the prefix "wakka_" in this code with whatever prefix is set in the configuration for your Wikka installation!** --JavaWoman
%%(sql)
CREATE TABLE `wakka_scheduler` (
`id` int(10) NOT NULL auto_increment,
`user` varchar(80) NOT NULL default '',
`day` tinyint(2) NOT NULL default '0',
`month` tinyint(2) NOT NULL default '0',
`year` mediumint(4) NOT NULL default '0',
`dayschedule` text,
PRIMARY KEY (`id`)
) TYPE=MyISAM;
%%
These actions rely on a "bad word function" which must be placed as a file called ##badwordfunction.php## located in a directory called ##scripts## located in the wiki root directory.
%%(php;1)
%%
below code added to actions directory as ##scheduler.php##. The action should be placed on a page called "ScheDule".
%%(php;1)
GetConfigValue("base_url");
$thispage=$this->GetPageTag();
// badword array for replacing badwords (not initialized as currently using added function in wakka.php)
//$badwords = Array ('/motherfucker/i', '/cunt/i', '/fuck/i', '/cocksucker/i', '/bitch/i', '/son of a bitch/i', '/asshole/i', '/shit/i', '/fag/i', '/wank/i', '/dick/i', '/pussy/i', '/bastard/i', '/molester/i', '/molezter/i', '/cock/i');
//$changeto = '****';
// gets username
$username = $this->GetUserName();
// kasper
// NOTE VERY IMPORTANT, if the table is totally empty the function will not work, you
// must add one in maually, for this function to work
// I could add it in the code but very messy, will come up with better way.
$dayschedule = $_POST['dayscheduleX'];
include_once("./scripts/badwordfunction.php");
$dayschedule = BadWordFunction($dayschedule);
$dayschedule = addslashes($dayschedule); // for single quotes to work
// replace above function call with line below if wakka.php doesn't have a bad word function code in it
//$dayschedule = preg_replace($badwords, $changeto, $dayschedule);
$query = "select * from ".$this->config['table_prefix']."scheduler";
$result = mysql_query($query);
if ($_POST['save']){
// Kasper added to delete the empty schedule
$del = "delete from ".$this->config['table_prefix']."scheduler where dayschedule = ''";
$delresult = mysql_query($del);
$up = 0;
while ($row = mysql_fetch_object($result))
{
if($row->user == $username && $row->month == $month && $row->day == $today && $row->year == $year)
{
$up = 1;
$ro = $row->id;
}
}
if($up == 1)
{
$query = "UPDATE ".$this->config['table_prefix']."scheduler SET dayschedule='$dayschedule' WHERE user='$username' AND id='$ro'";
$result = mysql_query($query);
}else{
$query = "INSERT into ".$this->config['table_prefix']."scheduler (user,dayschedule,month,day,year) VALUES ('$username','$dayschedule','$month','$today','$year')";
$result = mysql_query($query);
}
}
// end kasper
?>
GetUser())
{
$dayschedule = str_replace("\n", ",", $_POST['dayschedule']);
// title over textarea box
$printowner = $username."'s Schedule for ";
$dayschedule = $this->LoadSingle("SELECT dayschedule FROM ".$this->config["table_prefix"]."scheduler WHERE user='".$username."' AND day='".$today."' AND month='".$month."' AND year='".$year."'");
// replaced a comma with XXZXX below....I don't know what the purpose of the code is...
$dayschedule = str_replace("XXZXX", "\n", $dayschedule[dayschedule]);
$output = str_replace(",", " ", $dayschedule[dayschedule]);
?>
&year=&month="><< echo "$printowner$monthname $today, $year:"; ?>$lastday) ? 1 : $today+1 ; ?>&year=&month=">>>
}
else
{
echo "The Scheduler only works for logged-in users.";
} ?>
%%
The following is the action which shows a formatted output for a selected day....the current day (by default) or for any other day (using a link from the ##scheduler.php## & ##monthview.php## actions)....it should be saved into the actions directory as ##dayschedule.php## and for proper functioning with ##scheduler.php## should be placed on a page called ""DaySchedule"".
%%(php;1)
GetConfigValue("base_url");
$thispage=$this->GetPageTag();
$lastday = getLastDayofMonth($month,$year);
/*== get the last day of the month ==*/
function getLastDayofMonth($mon,$year)
{
for ($tday=28; $tday <= 31; $tday++)
{
$tdate = getdate(mktime(0,0,0,$mon,$tday,$year));
if ($tdate["mon"] != $mon) break;
}
$tday--;
return $tday;
}
// gets username
$username = $this->GetUserName();
$user = $username;
$dayschedule = $this->LoadSingle("SELECT dayschedule FROM ".$this->config["table_prefix"]."scheduler WHERE user='".$username."' AND day='".$today."' AND month='".$month."' AND year='".$year."'");
$printout = str_replace("\n", "
", $dayschedule[dayschedule]);
$printowner = $username."'s entries for ";
?>
if ($user = $this->GetUser())
{
if(!empty($printout))
{
echo $printout;
}
else
{
echo "There are no entries on this day.";
}
}
else
{
echo "Showing the day schedule only works for logged-in users.";
}
?>
%%
This is a screenshot of the ##dayschedule.php## output...
http://gmbtst.msvu.ca/wikitest/dayschedule.jpg
This final action show a month-view with all of the entries. It should be saved into the actions directory as ##monthscheduler.php## and for proper functioning with ##scheduler.php## the action should be placed on a page called ""MonthSchedule"".
%%(php;1)
GetConfigValue("base_url");
$thispage=$this->GetPageTag();
$username = $this->GetUserName();
// badword array for replacing badwords (not initialized as currently using added function in wakka.php)
//$badwords = Array ('/motherfucker/i', '/cunt/i', '/fuck/i', '/cocksucker/i', '/bitch/i', '/son of a bitch/i', '/asshole/i', '/shit/i', '/fag/i', '/wank/i', '/dick/i', '/pussy/i', '/bastard/i', '/molester/i', '/molezter/i', '/cock/i');
//$changeto = '****';
// gets username
$username = $this->GetUserName();
// kasper
// NOTE VERY IMPORTANT, if the table is totally empty the function will not work, you
// must add one in maually for this function to work.
// I could add it in the code but very messy, will come up with better way.
$dayschedule = $_POST['dayscheduleX'];
include_once("./scripts/badwordfunction.php");
$dayschedule = BadWordFunction($dayschedule);
$dayschedule = addslashes($dayschedule); // for single quotes to work
// replace above function call with line below if wakka.php doesn't have a bad word function code in it
//$dayschedule = preg_replace($badwords, $changeto, $dayschedule);
$query = "select * from ".$this->config['table_prefix']."scheduler";
$result = mysql_query($query);
if ($_POST['save']){
// Kasper added to delete the empty schedule
$del = "delete from ".$this->config['table_prefix']."scheduler where dayschedule = ''";
$delresult = mysql_query($del);
$up = 0;
while ($row = mysql_fetch_object($result))
{
if($row->user == $username && $row->month == $month && $row->day == $today && $row->year == $year)
{
$up = 1;
$ro = $row->id;
}
}
if($up == 1)
{
$query = "UPDATE ".$this->config['table_prefix']."scheduler SET dayschedule='$dayschedule' WHERE user='$username' AND id='$ro'";
$result = mysql_query($query);
}else{
$query = "INSERT into ".$this->config['table_prefix']."scheduler (user,dayschedule,month,day,year) VALUES ('$username','$dayschedule','$month','$today','$year')";
$result = mysql_query($query);
}
}
// end kasper
?>
if ($user = $this->GetUser())
{
$dayschedule = str_replace("\n", ",", $_POST['dayschedule']);
// title over textarea box
$printowner = $username."'s Schedule for ";
$dayschedule = $this->LoadSingle("SELECT dayschedule FROM ".$this->config["table_prefix"]."scheduler WHERE user='".$username."' AND day='".$today."' AND month='".$month."' AND year='".$year."'");
// replaced a comma with XXZXX below....I don't know what the purpose of the code is...
$dayschedule = str_replace("XXZXX", "\n", $dayschedule[dayschedule]);
$output = str_replace(",", " ", $dayschedule[dayschedule]);
?>
\n";
//html header, search form items, per page form
echo "\n";
//search function
function get_results($keyword, $linktm, $tm_page, $task_owner, $owner) {
//search the database
$strSQL = "SELECT * From ".$this->config["table_prefix"]."task WHERE task_delete = '0' AND user = '$task_owner' AND task_title LIKE '%".$keyword."%' OR task_content LIKE '%".$keyword."%'";
$results = mysql_query($strSQL);
if (mysql_num_rows($results) > 0) {
echo " Your keyword is: ".$keyword."
\n";
echo "
\n";
while($mykey = mysql_fetch_array($results)){
//list the results
echo "
\n";
echo "
\n";
switch ($mykey["task_status"]) {
case "Incomplete":
echo "".$mykey["task_status"]."\n";
break;
case "In Progress":
echo "".$mykey["task_status"]."\n";
break;
case "Complete":
echo "".$mykey["task_status"]."\n";
break;
}
echo "
\n";
}
}
//list items function
function list_todo($tm_order, $tm_direction, $linktm, $tm_page, $records_page, $task_timestamp, $task_status, $task_owner, $owner) {
if (!isset($tm_order)) {
$tm_order = "task_timestamp";
}
if (!isset($tm_direction)) {
$tm_direction = "DESC";
}
$begin = (($tm_page-1)*$records_page);
$strSQL = "SELECT * From ".$this->config["table_prefix"]."task WHERE task_delete = '0' AND user = '$task_owner' ORDER By $tm_order $tm_direction LIMIT $begin,$records_page";
$query = mysql_query($strSQL);
//ECHO 'START of list of items in the cell header information';
echo "
\n";
echo "
\n";
echo "
\n";
echo "TASK
\n";
echo "
\n";
echo "ENTERED ON
\n";
echo "
\n";
echo "STATUS
\n";
echo "
MODIFY
\n";
echo "
\n";
//ECHO 'START of list of items after HEADER information (why is this in the wrong place??)';
//list todo items
while ($todo = mysql_fetch_array($query)) {
echo "
\n";
echo "
".$todo["task_title"]."
\n";
echo "
".$todo["task_timestamp"]."
\n";
//items status case
switch ($todo["task_status"]) {
case "Incomplete":
echo "
\n";
}
mysql_free_result($results);
}
//view item after search function
function item2($task_id, $linktm, $tm_page, $task_owner, $owner, $order1, $dir1, $table) {
if($task_id == 'ALL'){
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user='$task_owner' ORDER By $order1 $dir1"; //kasper AND task_id =".$task_id;
$query = mysql_query($strSQL);
echo "
\n";
echo "
";
echo "
STATUS
\n";
echo "
TASK
\n";
echo "
ENTERED ON
\n";
echo "
";
while ($item = mysql_fetch_object($query)){
echo "
\n";
echo "
\n";
echo "
\n";
switch ($item->task_status) {
case "Incomplete":
echo "".$item->task_status."\n";
break;
case "In Progress":
echo "".$item->task_status."\n";
break;
case "Complete":
echo "".$item->task_status."\n";
break;
}
echo "
\n";
echo "
".strtoupper($item->task_title)."
";
echo "
".$item->task_timestamp."
\n";
echo "
".str_replace("\n", " ", $item->task_content)."
\n";
echo "
\n";
}
}
elseif ($task_id == 'INCOMPLETE'){
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user='$task_owner' AND task_status='Incomplete' ORDER By $order1 $dir1"; //kasper AND task_id =".$task_id;
$query = mysql_query($strSQL);
echo "
\n";
echo "
";
echo "
STATUS
\n";
echo "
TASK
\n";
echo "
ENTERED ON
\n";
echo "
";
while ($item = mysql_fetch_object($query)){
echo "
\n";
echo "
\n";
echo "
\n";
switch ($item->task_status) {
case "Incomplete":
echo "".$item->task_status."\n";
break;
case "In Progress":
echo "".$item->task_status."\n";
break;
case "Complete":
echo "".$item->task_status."\n";
break;
}
echo "
\n";
echo "
".strtoupper($item->task_title)."
";
echo "
".$item->task_timestamp."
\n";
echo "
".str_replace("\n", " ", $item->task_content)."
\n";
echo "
\n";
}
}
elseif ($task_id == 'INPROGRESS'){
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user='$task_owner' AND task_status='In Progress' ORDER By $order1 $dir1"; //kasper AND task_id =".$task_id;
$query = mysql_query($strSQL);
echo "
\n";
echo "
";
echo "
STATUS
\n";
echo "
TASK
\n";
echo "
ENTERED ON
\n";
echo "
";
while ($item = mysql_fetch_object($query)){
echo "
\n";
echo "
\n";
echo "
\n";
switch ($item->task_status) {
case "Incomplete":
echo "".$item->task_status."\n";
break;
case "In Progress":
echo "".$item->task_status."\n";
break;
case "Complete":
echo "".$item->task_status."\n";
break;
}
echo "
\n";
echo "
".strtoupper($item->task_title)."
";
echo "
".$item->task_timestamp."
\n";
echo "
".str_replace("\n", " ", $item->task_content)."
\n";
echo "
\n";
}
}
elseif ($task_id == 'COMPLETE'){
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user='$task_owner' AND task_status='Complete' ORDER By $order1 $dir1"; //kasper AND task_id =".$task_id;
$query = mysql_query($strSQL);
echo "
\n";
echo "
";
echo "
STATUS
\n";
echo "
TASK
\n";
echo "
ENTERED ON
\n";
echo "
";
while ($item = mysql_fetch_object($query)){
echo "
\n";
echo "
\n";
echo "
\n";
switch ($item->task_status) {
case "Incomplete":
echo "".$item->task_status."\n";
break;
case "In Progress":
echo "".$item->task_status."\n";
break;
case "Complete":
echo "".$item->task_status."\n";
break;
}
echo "
\n";
echo "
".strtoupper($item->task_title)."
";
echo "
".$item->task_timestamp."
\n";
echo "
".str_replace("\n", " ", $item->task_content)."
\n";
echo "
\n";
}
}
else
{
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user='$task_owner' AND task_id =".$task_id;
$query = mysql_query($strSQL);
$item = mysql_fetch_array($query);
echo "
\n";
echo "
\n";
switch ($item["task_status"]) {
case "Incomplete":
echo "".$item["task_status"]."\n";
break;
case "In Progress":
echo "".$item["task_status"]."\n";
break;
case "Complete":
echo "".$item["task_status"]."\n";
break;
}
echo "
\n";
}
}
//list items function
function list_todo2($tm_order, $tm_direction, $linktm, $tm_page, $records_page, $task_timestamp, $task_status, $task_owner, $owner, $table) {
if (!isset($tm_order)) {
$tm_order = "task_timestamp";
}
if (!isset($tm_direction)) {
$tm_direction = "DESC";
}
$begin = (($tm_page-1)*$records_page);
$strSQL = "SELECT * From ".$table."task WHERE task_delete = '0' AND user = '$task_owner' ORDER By $tm_order $tm_direction LIMIT $begin,$records_page";
$query = mysql_query($strSQL);
//ECHO 'START of list of items in the cell header information';
echo "
\n";
echo "
\n";
echo "
\n";
echo "TASK
\n";
echo "
\n";
echo "ENTERED ON
\n";
echo "
\n";
echo "STATUS
\n";
echo "
View?
\n";
echo "
\n";
//ECHO 'START of list of items after HEADER information (why is this in the wrong place??)';
//list todo items
while ($todo = mysql_fetch_array($query)) {
echo "
\n";
echo "
".$todo["task_title"]."
\n";
echo "
".$todo["task_timestamp"]."
\n";
//items status case
switch ($todo["task_status"]) {
case "Incomplete":
echo "
\n";
mysql_free_result($query);
}
?>
%%
Ultimately, it is intended that a text entry box and a submit button will be added to this code for entering user names so the schedule of any user can be easily obtained without editing the page.
**Remember**, multiple copies of mytasks.php cannot be on the same page at once.
And, of course, you need to create a new table in your database....
''Remember that you may need to replace wikka_ (first line) with your wikkas table prefix''
%%(sql)
CREATE TABLE `wikka_task` (
`task_id` int(11) NOT NULL auto_increment,
`user` text NOT NULL,
`task_timestamp` datetime NOT NULL default '0000-00-00 00:00:00',
`task_title` varchar(255) NOT NULL default '',
`task_content` text NOT NULL,
`task_status` varchar(255) default NULL,
`task_delete` tinyint(1) NOT NULL default '0',
PRIMARY KEY (`task_id`)
) TYPE=MyISAM;
%%
----
The mytasks.php function on this page use a "bad word function" that should be placed in the wakka.php file in the wiki root directory. The following code needs to be placed in the wakka.php file (just after the microtime function which starts "function getmicrotime" and ends with a "}". This code is placed immediately after the "}".
%%(php)
//GMB remove bad word filter
function BadWordFunc($RemoveBadWordText) {
$RemoveBadWordText = eregi_replace("fuc?k|[kc]unt|motherfucker|cocksucker|bitch|son of a bitch|asshole|shit|fag|wank|dick|pu[zs]?[zs][yi]|bastard|s[kc]rew|mole[zs]ter|mole[sz]t|coc?k", "", $RemoveBadWordText);
return $RemoveBadWordText;
%%
----
In mytasks.php use something like this:
%%(php)
if ($this->method == "show") {
global $tableprefix;
$tableprefix = $this->config["table_prefix"];
%%
and inside function use global $tableprefix; and in query "... FROM ${tableprefix}task ...." **do not use $this->config["table_prefix"] inside function PHP 5.1.x do not understand**
----
CategoryUserContributions