או איך התקנתי ויקי אצלי בחברה - רשומה 3 בסדרה
רשומה 1 - מהו ויקי, יתרונותיו ולמי זה מתאים.
רשומה 2 - איך להתקין ויקי.
רשומה זו עוסקת כיצד לבצע את ההתאמות הקטנות אשר נותנות את הייתרונות הגדולים של מערכת הויקי.
הכירו את קובץ LocalSettings.php
אם עקבתם אחר הנחיות ההתקנה של הרשומה הקודמת קובץ הקונפיגורציה נמצא תחת ספריית HTDOCS של תוכנת ה- APACHE בצורה הבאה:
(כאשר "X" הינו שם הספרייה של הויקי)
קובץ זה נקרא LocalSettings.php, והוא זה השולט לנו על הממשק, תוספות והגדרות של הויקי.
כל השינויים/עדכונים יעברו דרכו, כך שחשוב מידי פעם לבצע גיבוי לקובץ זה, גם בטרם הכנסת שינויים - כך נוכל להחזיר את המצב לקדמותו.
לצורך עריכת הקובץ נוכל להשתמש בכל עורך טקסטואלי (Notepad, Word וכד').
עמוד ראשי / לוגו חברה
העמוד הראשי הוא העמוד אשר כל אדם שנכנס לויקי יראה, חשוב להכניס מספר מילות פתיחה.
עמוד זה יכול לשמש כמעין פורטל, להפנות לפרויקטים, להכיל קישורים שימושיים, מדריכי משתמש, הסברים, הנחיות ו/או כל מידע אחר הרלוונטי לארגון.
בפעם הראשונה שתפתחו את הויקי הלוגו בפינה הימנית העליונה יהיה של MEDIAWIKI, אנו בקלות נכניס את הלוגו של החברה שלנו:
רשומה 1 - מהו ויקי, יתרונותיו ולמי זה מתאים.
רשומה 2 - איך להתקין ויקי.
רשומה זו עוסקת כיצד לבצע את ההתאמות הקטנות אשר נותנות את הייתרונות הגדולים של מערכת הויקי.
הכירו את קובץ LocalSettings.php
אם עקבתם אחר הנחיות ההתקנה של הרשומה הקודמת קובץ הקונפיגורציה נמצא תחת ספריית HTDOCS של תוכנת ה- APACHE בצורה הבאה:
C:\Program Files (x86)\Apache Software Foundation\Apache2.2\htdocs\X
(כאשר "X" הינו שם הספרייה של הויקי)
קובץ זה נקרא LocalSettings.php, והוא זה השולט לנו על הממשק, תוספות והגדרות של הויקי.
כל השינויים/עדכונים יעברו דרכו, כך שחשוב מידי פעם לבצע גיבוי לקובץ זה, גם בטרם הכנסת שינויים - כך נוכל להחזיר את המצב לקדמותו.
לצורך עריכת הקובץ נוכל להשתמש בכל עורך טקסטואלי (Notepad, Word וכד').
עמוד ראשי / לוגו חברה
העמוד הראשי הוא העמוד אשר כל אדם שנכנס לויקי יראה, חשוב להכניס מספר מילות פתיחה.
עמוד זה יכול לשמש כמעין פורטל, להפנות לפרויקטים, להכיל קישורים שימושיים, מדריכי משתמש, הסברים, הנחיות ו/או כל מידע אחר הרלוונטי לארגון.
דוגמא לעמוד ראשי |
- מצאו/בקשו קובץ לוגו של החברה בגודל המתאים (לצורך הדוגמא שמו יהיה com_logo.png).
- היכנסו לתת ספרייה
skins/common/images בתוך ספריית הויקי ("X"), והעתיקו את הקובץ לכאן.
כעת נעדכן את קובץ הקונפיגורציה. פתחו את localsettings.php ומצאו את "$wgLogo" (אם הוא לא קיים יש ליצור אותו) וכעת עדכנו אותו לשם הקובץ החדש:
$wgLogo = "$wgStylePath/common/images/
com_logo.png";
הסבר מפורט מאתר MediaWiki
עריכת ויקי בקלות / WYSIWYG
מי מאיתנו שניסה אי פעם לערוך דף ויקי כלשהו נתקל בוודאי בשפה חדשה, תגיות טקסטואליות ייחודיות לויקי אשר מאפשרות שליטה על התוצאה הסופית: עיצוב (Bold, Italic, Underline), יצירת טבלאות, קישורים, הוספת תמונות ועוד.
לאדם מן השורה אין ספק ששימוש בממשק זה אינו נוח (בלשון במעטה), ויקשה את השימוש בויקי.
לכן אני ממליץ בחום להשתמש בממשק טבעי.
מהו ממשק טבעי?
ובכן ממשק טבעי, ממש כמו בתוכנת WORD, היא ההגדרה של ממשק בו מה שרואים על המסך בזמן ההקלדה הוא התוצר הסופי שייראה על המסך כאשר נשמור את העמוד.
לדוגמא, הכנסת כותרת בשפת ויקי תראה כך:
== Title ==
ואילו בממשק טבעי בזמן ההקלדה פשוט נראה:
Title
בלעז ממשק זה נקרא What You See Is What You Get, ולרוב נראה את הקיצור שלו WYSIWYG.
הממשק הנבחר
לאחר בחינת מספר ממשקים, נתקלתי בממשק טבעי נוח ופשוט להתקנה של חברת Semantic Media Wiki:
ספריית הויקי |
מי מאיתנו שניסה אי פעם לערוך דף ויקי כלשהו נתקל בוודאי בשפה חדשה, תגיות טקסטואליות ייחודיות לויקי אשר מאפשרות שליטה על התוצאה הסופית: עיצוב (Bold, Italic, Underline), יצירת טבלאות, קישורים, הוספת תמונות ועוד.
לאדם מן השורה אין ספק ששימוש בממשק זה אינו נוח (בלשון במעטה), ויקשה את השימוש בויקי.
לכן אני ממליץ בחום להשתמש בממשק טבעי.
מהו ממשק טבעי?
ובכן ממשק טבעי, ממש כמו בתוכנת WORD, היא ההגדרה של ממשק בו מה שרואים על המסך בזמן ההקלדה הוא התוצר הסופי שייראה על המסך כאשר נשמור את העמוד.
לדוגמא, הכנסת כותרת בשפת ויקי תראה כך:
== Title ==
ואילו בממשק טבעי בזמן ההקלדה פשוט נראה:
Title
בלעז ממשק זה נקרא What You See Is What You Get, ולרוב נראה את הקיצור שלו WYSIWYG.
הממשק הנבחר
לאחר בחינת מספר ממשקים, נתקלתי בממשק טבעי נוח ופשוט להתקנה של חברת Semantic Media Wiki:
- היכנסו לדף ההורדות ושמרו את WYSIWYG 1.5.6.
- את תוכן תקיית WYSIWYG בתוך הקובץ הכניסו לתוך תקיית הויקי
..\htdocs\X\extensions\WYSIWYG
- הכניסו את הטקסט הבא לתוך קובץ LocalSettings.PHP:
require_once("$IP/extensions/WYSIWYG/WYSIWYG.php");
$wgGroupPermissions['*']['wysiwyg']=true;
$wgDefaultUserOptions['riched_start_disabled'] = false;
$wgDefaultUserOptions['riched_use_toggle'] = true;
$wgDefaultUserOptions['riched_use_popup']= false;
$wgGroupPermissions['*']['wysiwyg']=true;
$wgDefaultUserOptions['riched_start_disabled'] = false;
$wgDefaultUserOptions['riched_use_toggle'] = true;
$wgDefaultUserOptions['riched_use_popup']= false;
- שורה 1 - מאפשרת את התוסף בתוך הויקי.
- שורה 2 - נותנת לכל המשתמשים הרשאות לשימוש בתוסף.
- שורה 3 - הופכת את WYSIWYG לעורך הראשי.
- שורה 4 - מאפשר מעבר מהעורך הטבעי לעורך הרגיל של הויקי.
- שורה 5 - הופכת את העורך הטבעי לחלק אינטגרלי מהדפדפן.
- קישור להוראות ההתקנה באתר SMW - בשונה מהרשום במדריך זה, הממשק נבדק ועובד על גרסא 1.17.0 של MediaWiki.
- השימוש בעורך הטבעי הוא די אינטואיטיבי, אך במידה ותרצו להתעמק בכל הפונקציות שלו - להלן קישור למדריך המשתמש בממשק.
כך נראה העורך של הממשק בטבעי |
עם כל הייתרונות של ממשק זה, ישנה מגבלה לשימוש בו:
- עובד עם דפדפן IE מגרסא 8 ומעלה בלבד.
שימוש בדוא"ל כחלק מהויקי
אחת הפונקציות שכנראה תרצו להטמיע בתוך הויקי היא היכולת שלו לשלוח דוא"ל.
הפונקציה הזו כשלעצמה אינה מהותית בתוך ארגון, כאשר ניתן לשלוט באופן יחסי על רישום משתמשים, אך היא מאפשרת אימות דוא"ל של משתמשים חדשים, תזכורות לחידוש סיסמאות שפגו תוקף והיא משתלבת עם תוסף אחר שנדבר עליו בהמשך.
לצורך כך תהיו חייבים את התמיכה הטכנית של גורם IT. יש צורך להגדיר עבור הויקי משתמש עם תיבת דוא"ל בשרת ה- Exchange, ולבקש מספר פרטים נוספים עליהם נעמוד בהמשך.
התקנת PEAR
תוסף הדוא"ל המומלץ ע"י MediaWiki הינו רכיב PHP הנקרא PEAR.
לצורך התקנתו נבצע את השלבים הבאים:
- נוריד את הגרסא העדכנית מ- http://pear.php.net/go-pear.phar.
- נפתח שורת פקודה (Command line).
- ניכנס לספריה בה שמרנו את הקובץ ונריץ את פקודת ההתקנה הבאה: php go-pear.phar
- קישור למדריך הרשמי של התוכנה.
לאחר
ההתקנה יש לוודא בתוך קובץ PHP.ini כי
מופיע הטקסט הבא:
include_path=".;C:\Program
Files (x86)\PHP\pear\"
(תלוי כמובן היכן התקנתם את ה- PHP שלכם,
באותה מידה זה יכול להיות C:\PHP\pear\) ובסיום יש לאתחל את השרת.
עכשיו אחרי שהתקנו PEAR אפשר להתקין את כל תוספי הדוא"ל שלו.
התקנת MAIL
- נוריד את הגרסא העדכנית מ- http://pear.php.net/package/Mail.
- נפתח שורת פקודה (Command line).
- ניכנס לספריה בה שמרנו את הקובץ ונריץ את פקודת ההתקנה הבאה: pear install Mail
התקנת Net_SMTP
- נוריד את הגרסא העדכנית מ- http://pear.php.net/package/Net_SMTP.
- נפתח שורת פקודה (Command line).
- ניכנס לספריה בה שמרנו את הקובץ ונריץ את פקודת ההתקנה הבאה: pear install Net_SMTP
התקנת Net_Socket
- נוריד את הגרסא העדכנית מ- http://pear.php.net/package/Net_Socket.
- נפתח שורת פקודה (Command line).
- ניכנס לספריה בה שמרנו את הקובץ ונריץ את פקודת ההתקנה הבאה: pear install Net_Socket
הערה: אם אחד הרכיבים כבר מותקן, ורק תרצו לשדרג את הגרסא, במקום לרשום install רשמו upgrade.
הגדרות בקובץ LocalSettings
לאחר שביצענו את כל ההתקנות יש לסיים ולבצע את ההגדרות בקובץ הקונפיגורציה:
$wgSMTP = array( 'host' => "mail.example.com", //could also be an IP address 'IDHost' => "example.com", 'port' => 25, 'auth' => true, 'username' => "my_user_name", 'password' => "my_password" );
כאן כמובן שיש להעזר בגורם הטכני/IT על מנת למלא את כל פרטי שרת הדואר. אצלי לדוגמא לא היה צורך באימות בשרת ולכן אופציית "auth" היא "false".
בדיקת תקינות הדוא"ל
לבדיקה כעת שהשרת מצליח לשלוח מיילים היכנסו ל "העדפות שלי" ללשונית "פרטי משתמש", ותחת סעיף "אפשרויות דוא"ל" תהיה אופציה לבצע אימות.
אם הכל עובד כשורה לאחר לחיצה על אופציה זו תקבלו הודעה לתיבה שלכם המבקשת שתלחצו על קישור ואז יבוצע אימות אל מול השרת.
אימות תיבת דוא"ל |
מערכת לניהול באגים ISSUETRACKER
אחת האופציות ממנה התלהבתי קצת יותר הינו תוסף זה המאפשר פתיחת טבלת באגים.כאשר אם הגדרתם את הדוא"ל כמו שצריך, תוכלו לפתוח תקלות לגורם כלשהו והוא יקבל זאת ישירות לתיבה שלו.
כך נראית הטבלה בתוך הויקי |
לצערי השמשת תוסף זה דורשת קצת עבודה שחורה, אני אסביר כיצד לבצע זאת כאן:
- קישור לאתר התוסף http://www.mediawiki.org/wiki/Extension:IssueTracker
- תחילה נוריד את קבצי התוסף ונעתיק אותם לתוך ספריית IssueTracker תחת ספריית extensions.
- הכניסו את הטקסט הבא לתוך קובץ LocalSettings.PHP:
require_once $IP . '/extensions/IssueTracker/IssueTracker.php';
- לאחר מכן יש לעדכן טבלה בתוך ה- SQLSERVER, לצורך כך נתקין את תוכנת WORKBENCH.
- התקנת Microsoft Visual C++ 2010 Redistributable Package x86 - קישור
- התקנת Microsoft .NET Framework 4 Client Profile - קישור
- התקנת MySQL Workbench 5.2.34 - קישור
- ניצור קובץ טקסט, בעל סיומת SQL המכיל את המלל הבא (כפי שמופיע באמתר התוסף):
CREATE
TABLE `issue_tracker` (
`issue_id`
int(10) NOT NULL auto_increment,
`type`
varchar(5) NOT NULL default 't_bug',
`title`
varchar(100) NOT NULL,
`summary`
text NOT NULL,
`status`
varchar(5) NOT NULL default 's_new',
`assignee`
varchar(40) NOT NULL,
`user_name`
varchar(40) NOT NULL,
`user_id`
int(10) NOT NULL,
`project_name`
varchar(100) NOT NULL,
`deleted`
int(1) NOT NULL default '0',
`history`
text NOT NULL,
`priority_date`
datetime NOT NULL default '0000-00-00 00:00:00',
`date_created`
timestamp NOT NULL default CURRENT_TIMESTAMP,
PRIMARY
KEY (`issue_id`),
KEY
`user_id` (`user_id`)
);
קובץ זה שולט על תצורת הטבלה - כך שאם נרצה שהטבלה תהיה קצת שונה, אז זה המקום לעשות זאת.- לאחר שיצרנו את הקובץ נפתח את תוכנת ה- Workbench ואת בסיס הנתונים.
בחירת בסיס הנתונים |
- ולאחר שביצענו זאת, ניתן לבחור בצד השמאלי העליון את "Execute SQL file" ולבחור את הקובץ SQL שיצרנו קודם לכן. פעולה זו תוסיף טבלה חדשה לבסיס הנתונים אשר תהווה את הבסיס למערכת.
- עכשיו נחזור לעמוד התוסף ונקרא את ההערות בתחתית העמוד המורות על תיקון באגים הקיימים בתוכנה. באותה צורה נלך ללשונית "Discussions" ונוסיף את המלל הרלוונטי לשליחת מיילים לקבצים המבוקשים.
- למתקשים ביצעתי את התיקונים הרלוונטיים וניתן להוריד אותם כאן.
זהו - כעת תוכלו להוסיף לכל דף ויקי טבלת באגים/תקלות.
תעשו זאת ע"י הכנסת התגית הבאה לתוך העמוד (יש לעבור לעורך ויקי הרגיל לצורך הוספת התגית):
<issues project="My Project" />
כאשר רצוי להחליף את "My Projects" בשם הפרויקט או הטבלה,
כך שניתן להכניס את אותה טבלה למספר דפי ויקי במקביל.
More Extensions
ל MediaWiki תוספים רבים, כאשר ניתן להתקין כל תוסף ע"פ הצורך.
כך שניתן להכניס את אותה טבלה למספר דפי ויקי במקביל.
More Extensions
ל MediaWiki תוספים רבים, כאשר ניתן להתקין כל תוסף ע"פ הצורך.
אבטחה וניהול משתמשים
ברשומה הבאה אתמקד בסוגיית האבטחה וניהול הויקי, אופציות אלו יאפשרו שליטה על מי שנרצה שיכנס לויקי (שליטה וניהול משתמשים), ואבטחת דפים ספציפיים (אם יש צורך במידור פנים ארגוני).