BlogNewsCMS is a versatile Single user Blog/News or CMS for an Article/Content Based Website.
The Admin Interface gives you full control over the Articles you are publishing.
New Item
This Form lets you add an Item to your website. It has 4 Fields that should be completed.
- Title
- keywords
- Item Summary
- Item
Title Is Used in several places. It is the Page Title*, Can Be part of the URL*, Anchor Text to the complete Article, Title in the Headlines and Finally, the Item Title in your RSS Feed.
keywords Is an optional field, and when populated, it is used for meta keywords in a web page*
Item Summary Is used as the content for the Headlines and the Item Contents for your RSS Feed. It is also use d as a Meta description*
The Item is of course the actual Article/News story/Blog entry you are creating. In order for you to be able to create and manage your content, we have built some powerful Features around the management of this content. We have created a Series of BBCodes that you can use to enhance your articles.
In order to offer even more control over your articles, we have a special code you can insert into the body. The cod e which is [--break--] Does exactly what it says - It breaks an Item up. On any rendered pages where there is more tha n 1 Item, if an Item has a [--break--] tag within it, the contents BEFORE the tag will be shown - with a link to read the ful l article. When you go to read the full article, this tag will simply be stripped out, preseting the whole article for your readers.
* Where an article is on a page with multiple articles, the details from the First Article on the Page are used in creating the page.
BBCodes
BBCodes are custom "tags" that you can use to enhance your article. The Codes are Very Simple and are very similar t o html.
- Tags
- [h]Text[/h] - Converts Text to
Heading 3 <h3>
- [b]Bold Text[/b] - Converts to Bold Text
- [img]http://example.com/image/img.jpg[/img] - Displays an Image with the CSS Class of BNC_i
- [img1]http://example.com/image/img.jpg[/img1] - Displays an Image with the CSS Class of BNC_i1
- [img2]http://example.com/image/img.jpg[/img2] - Displays an Image with the CSS Class of BNC_i2
- [s1] Some Text[/s1] Wraps the Text in <span> Tags with a CSS Class of BNC_s1
- [s2] Some Text[/s2] Wraps the Text in <span> Tags with a CSS Class of BNC_s2
- [d1] lots of content [/d1] Puts Lots of Content into a <div> with the CSS Class of BNC_d1
- [url=http://example.com]anchor text[/url] Allows you to put a hyperlink into your document. Anchor Text can even b e an Image by using the appropriate BBCode!
There are a couple of things to consider when using BBCode. The main one is that you must have a PAIR - an opening a nd closing tag, and if you are using the same tags, You MUST close one BEFORE opening a new one otherwise you will get unexpe cted Results.
You will notice that some of these Tags are almost duplicates of other tags. This is done on purpose, in order to gi ve you as much flexibility as possible in designing the Layout and apperance of your website using CSS.
CSS and Templates - Styling your Articles
In Order for you to be able to have total control over the look of your website we created a Templating system that is ver y easy to customise. To give you the maximum flexibility, we have additionally given you the ability to modify the appe rance of every single element (with the exception of the "powered By" Box) on a rendered Web Page.
CSS Classes explained
- .blogitem - the div that encloses each item
- .pagination - the div that encloses the navigation (next page etc)
- .errmsg - wrapped around warning messages generated
- .spacer - used to provide some extra space in a br just abouve the h2 around the item title
- .CreatedOn - around the created on date span
- .BNC_readmore - span that has the link to the full article
- .news - p around each item returned by headlines.php
- .BNC_i - added to the img BBCode
- .BNC_i1 - added to the img1 BBCode
- .BNC_i2 - added to the img2 BBCode
- .BNC_s1 - added to the s1 BBCode
- .BNC_s2 - added to the s2 BBCode
- .BNC_d1 - added to the d1 BBCode
With all generated content, and all the BBCodes you have at your disposal you can see that you can acheive the look that y ou want
Templates Explained
There are 4 files that make up a skin.
Skins live in the skins directory, and the skin name is the sub-directory in which the 4 skin files live.
The 4 files are header.php, template.php, footer.php and style-default.css (there is also an empty index.html file to stop anyone browsing your directory structure)
There is only 1 file that is absolutely needed for this system to work and that is the template.php file.
Simple Howto
Simply point your web browser to http://yoursite.com/yourdirectory/Admin.php and enterthe Username and Password that you put into the config.php file. From Here, you will be able to add new Items, Update and Delete Existing Items
Once you have added some content, point your Browser to http://yoursite.com/yourdirectory/BlogNewsCMS.php to view it.
The RSS feed for your content can be found at http://yoursite.com/yourdirectory/RSS2_0.php - and there is a Link to the RSS feed from the View Page.
To include your headlines in any other page on your site (or even any of your partner sites) simply use the following for PHP enabled sites
Of course, you need to modify the code to reflect where Headlines.php is on your server. Additionally, you could use an iframe to put the headlines into your page.
