%% LyX 1.3 created this file.  For more info, see http://www.lyx.org/.
%% Do not edit unless you really know what you are doing.
\documentclass[finnish]{article}
\usepackage[T1]{fontenc}
\usepackage[latin1]{inputenc}
\IfFileExists{url.sty}{\usepackage{url}}
                      {\newcommand{\url}{\texttt}}

\makeatletter
\usepackage{babel}
\makeatother
\begin{document}

\title{Newsadmin - Simple PHP news publishing system for web pages}


\author{(C) 2004 AD Tuomas Airaksinen}

\maketitle

\section{Credits}

For the glory of God, hacked by Tuomas Airaksinen.


\section{Purpose}

I hacked this little and relatively simple script for Jyväskylä Free
Church, because there was a need for it. I didn't find any other script
that would have filled this purpose nicely, because it was not meaningfull
to have full-blown content-management system, but just a simple way
for pastors to write short news articles. I wanted to release it for
public because of its (enough) general implementation and the need
that was apparent on many other pages as well. 


\subsection{Examples of usage}

\begin{itemize}
\item This script has been used for

\begin{itemize}
\item Maintaining {}``current affairs'' or ''latest news''-column on
a web site of church or any other organization 
\item Personal web log on any private homepage.
\end{itemize}
\end{itemize}

\section{Features}


\subsection{Demonstration - see it yourself working}

\begin{itemize}
\item Go to \url{http://tuma.stc.cx/newsadmindemo/}. Feel free to try out
all the features (like writing news :) ) there! 
\end{itemize}

\subsection{Features listed}

\begin{itemize}
\item There can be several editors that can type and publish news. Afterwards,
they can modify or delete their news.
\item There can be several different administrators that can add, delete
and modify other editors and admins. 
\item Editor has possibility to upload a picture related to news. If ImageMagick
is present on the server, the script uses 'convert'-tool to resize
it to wanted size.
\item It is easy to print news with print\_news(num)-function. print\_news
also cuts long articles (maximum length configurable) and links to
readarticle.php with which you can see whole article.

\begin{itemize}
\item If you know HTML and a little PHP (okay, you ONLY need some common
sense...) you can also make your own printing functions in printfunctions.php.
\end{itemize}
\item Gnu Gettext is used used to translate translate this into foreign
languages. If you translate this application to your language, please
send me .po file :) Translatable .po-files are in po/-directory and
they are installed in locale/-directory. Read po/HOWTO-TRANSLATE.txt
\item Simple news archive page to crawl the past.
\item You can process articles trough parsewiki if you want to use its formatting
features (configuration variable). This requires perl to be installed.
Doesn't work if php is in safe mode (shell\_exec doesn't work then).
See \url{http://doc.tikiwiki.org/tiki-index.php?page=Wiki+Text+Formatting}
to have an idea how it works when enabled.
\item And that's not all! In addition there is:

\begin{itemize}
\item Calendar script by ikemcg with which you can edit events. One week
onwards can be printed on your web page with print\_thisweek() from
functions.php;. Login to calendar with same usernames\&passwords as
in newsadmin.
\end{itemize}
\end{itemize}

\section{How to install and use it}

First, you better know what is an SQL server (MySQL). It is also nice
if you know what is PHP and HTML and know where to put the files to
make them work.


\subsection{Installation}

\begin{enumerate}
\item Install (or ask your admin to install) required programs on server
(Apache, PHP4, MySQL, ImageMagick). Apache must have PHP4 support
enabled an PHP4 must have support for MySQL and gettext. If gettext
support doesn't exists, you can use only english language.
\item Download newsadmin from http://tuma.stc.cx/newsadmin.php (downloads
are in the end of page)
\item Unpack the package and modify newsadmin-config.php to fullfill your
purposes.
\item Put php files into your web directory (for example \textasciitilde{}/public\_html/).
\item Make sure a directory {}``newspics'' exists on server and that the
web server has permission to write in it. 
\item Create tables on MySQL-server by going to http://yoursite/yourwebdir/newsadmin-createtables.php. 
\item Go to http://yoursite/yourwebdir/newsadmin.php. Log in using username
admin and password admin. 
\item Create necessary editors and administrators using newsadmin.php. 
\item Write some news articles
\item Check out your articles in http://yoursite/yourwebdir/archive.php
and http://yoursite/yourwebdir/index.php
\item Go ahead in calendar/, login with any username \& password you have
created, and add some events for next week.
\item Go again to http://yoursite/yourwebdir/index.php and see them there.
\item Edit your main page to require newsadmin-functions.php and make function
call print\_news(num) {[}where num is number of news items to show{]}
there to show news topics. You can see the example in index.php shipped
within the package. 
\item Teach the editors how to use newsadmin.php.
\end{enumerate}

\section{Translating (using gettext)}

\begin{itemize}
\item Read HOWTO-TRANSLATE.txt in po/ directory (comes with the package).
\end{itemize}

\section{Technical support}


\subsection{Security}

If you find bugs or security holes, let me know (email me). Or even
better: fix them and send me a patch or fixed version.


\subsection{Christian churches}

If you represent some christian church, I'm may be somewhat willing
to help you getting started. Don't send stupid questions, though.
And it depends very much about the situation if I'm willing at all.


\subsection{All other}

No (free) support at all. Don't email me stupid questions. There exists
a forum for this script on my web page, you may send your questions
there. If I'm in good mood I may try to answer . <http://tuma.stc.cx/phpbb/>. 

And of course: anyone can pay me and I'll happily do anything you
want...


\section{Licence}

This is free software and is licenced under GNU General Public Licence
(GPL). Read file COPYING shipped within the package.
\end{document}
