wiki:Contrib/IntegrateIntosNews

Integrate WYMeditor into sNews CMS

This page explains step by step how to integrate WYMeditor version 0.4 into sNews version 1.6. sNews is a light and open source Content Management System. All information about sNews is available on its  official site.

Since sNews already includes an editor, some hacks are mandatory in order to replace the default editor with WYMeditor. These hacks are all listed below. Fortunately, in order to avoid you these tedious code modifications, a ready-to-run archive file has been prepared and attached to this page. Unarchive this file and install sNews according to readme.html before to run it. Hacks made inside sNews have all been enclosed between tags [WYMeditor Hack] for allowing you to easily retreive them.

Install sNews

Download archive file  sNews16.zip

Unarchive sNews16.zip under your Web space and follow the install instructions contained into readme.html.

Install WYMeditor

Download archive file  wymeditor-0.4.tar.gz

Unarchive wymeditor-0.4.tar.gz into a temporary directory and move directories 'jquery' and 'wymeditor' into 'sNews' root directory

Integrate WYMeditor

All the following code modifications must be made in snews.php.

Replace line 325

	if ($_SESSION[db('website').'Logged_In'] == token()) {js();}

with

	if ($_SESSION[db('website').'Logged_In'] == token()) {js();
		echo
'	<link rel="stylesheet" type="text/css" media="screen" href="wymeditor/skins/default/screen.css" />
	<script type="text/javascript" src="jquery/jquery.js"></script>
	<script type="text/javascript" src="wymeditor/jquery.wymeditor.js"></script>
	<script type="text/javascript">
		jQuery(function() {
			jQuery(".wymeditor").wymeditor({
				cssPath: "'.db('website').'wymeditor/skins/default/screen.css",
				jQueryPath: "'.db('website').'jquery/jquery.js",
				wymPath: "'.db('website').'wymeditor/jquery.wymeditor.js"
			});
		});
	</script>';
	}

This code loads WYMeditor with its default skin and initializes WYMeditor with correct paths.

Replace line 1048

		case 'textarea': $output = '<p>'.$lbl.':<br /><textarea name="'.$name.'" rows="'.$rows.'" cols="'.$cols.'"'.$attribs.'>'.$value.'</textarea></p>'; break;

with

		case 'textarea':
			if ($_SESSION[db('website').'Logged_In'] == token()) {
				$output = '<p>'.$lbl.':<br /><textarea class="wymeditor" name="'.$name.'" rows="'.$rows.'" cols="'.$cols.'"'.$attribs.'>'.$value.'</textarea></p>'; break;
			} else {
				$output = '<p>'.$lbl.':<br /><textarea name="'.$name.'" rows="'.$rows.'" cols="'.$cols.'"'.$attribs.'>'.$value.'</textarea></p>'; break;
			}
			break;

This code allows WYMeditor to replace the 'textarea' block with a WYMeditor instance.

Comment from line 1312

/*	echo '<p>';

to line 1322

	echo '</p>';*/[/code]

This code disables the default editor toolbar.

Replace line 1327

	echo html_input('fieldset', '', '', '', '', '', '', '', '', '', '', '', '', '', '<a title="'.l('customize').'" onclick="toggle(\'preview\')" style="cursor: pointer;">'.l('preview').'</a>');

with

	if ($_SESSION[db('website').'Logged_In'] == token()) {
		echo html_input('fieldset', '', '', '', '', '', '', '', '', '', '', '', '', '', '<a title="'.l('customize').'" class="wymupdate" onclick="toggle(\'preview\')" style="cursor: pointer;">'.l('preview').'</a>');
	} else {
		echo html_input('fieldset', '', '', '', '', '', '', '', '', '', '', '', '', '', '<a title="'.l('customize').'" onclick="toggle(\'preview\')" style="cursor: pointer;">'.l('preview').'</a>');
	}

This code allows the edited article to be correctly previewed by sNews each time the sNews preview button is clicked.

Replace line 1393

	echo html_input('submit', $frm_task, $frm_task, $frm_submit, '', 'button', '', '', '', '', '', '', '', '', '');

with

	echo html_input('submit', $frm_task, $frm_task, $frm_submit, '', 'wymupdate', '', '', '', '', '', '', '', '', '');

This code allows the edited article to be correctly saved when the sNews save button is clicked.

That's all, sNews should now run WYMeditor instead of its default editor. If you experiment problems in running or using WYMeditor inside sNews, you are invited to read  this topic on the WYMeditor forum or  this one on the sNews forum. If you don't find the answer to your problem, feel free to post a new message.

Attachments