public
Description: The ultra-lightweight ultra-flexible blogging engine with a fetish for birds and misspellings.
Homepage: http://chyrp.net/
Clone URL: git://github.com/vito/chyrp.git
Click here to lend your support to: chyrp and make a donation at www.pledgie.com !
chyrp /
name age message
file .gitignore Wed Jun 11 12:36:03 -0700 2008 Split sidebar into its own file. [vito]
file COPYING Wed Mar 12 14:09:21 -0700 2008 Updated .po files. [vito]
file README.markdown Fri Jun 27 23:58:10 -0700 2008 * Updated README.markdown * Added further docum... [vito]
directory admin/ Wed Jul 09 16:46:44 -0700 2008 Trying to resolve a conflict. [brucep]
directory feathers/ Tue Jul 01 18:54:00 -0700 2008 Slight adjustment to youtube detecting. [vito]
file gettext.rb Tue Jun 24 19:01:30 -0700 2008 Updated version numbers in .pot files. [vito]
directory importers/ Thu Jul 03 12:33:51 -0700 2008 * New Trigger->filter. First argument is the ta... [vito]
directory includes/ Fri Jul 04 06:56:19 -0700 2008 Merge branch 'master' of git@github.com:vito/ch... [brucep]
file index.php Thu Jul 03 12:33:51 -0700 2008 * New Trigger->filter. First argument is the ta... [vito]
file install.php Thu Jul 03 01:28:26 -0700 2008 * Updated the installer * Added SQL->replace fo... [vito]
directory modules/ Thu Jul 03 23:22:41 -0700 2008 Fixed comment counts not displaying when 0. [vito]
file sanitize.py Fri May 23 18:57:53 -0700 2008 Some admin UI improvements (Thanks to Chris Vol... [vito]
directory themes/ Thu Jul 03 23:14:53 -0700 2008 * Fixes to the new Trigger->filter method * Inc... [vito]
file triggers.rb Wed Apr 30 15:19:30 -0700 2008 Gettext updates. [vito]
file triggers_list Thu Jul 03 12:33:51 -0700 2008 * New Trigger->filter. First argument is the ta... [vito]
file update_gettext Mon Jun 30 16:55:58 -0700 2008 Fixed 'foo by bar' text not being picked up by ... [vito]
file upgrade.php Thu Jul 03 01:28:26 -0700 2008 * Updated the installer * Added SQL->replace fo... [vito]
README.markdown

Chyrp is a blogging engine designed to be lightweight while retaining functionality. It is driven by PHP and MySQL (or SQLite), and has a great standard theme and robust module engine. You can personalize and modify it any way you want.

All of your content is powered by a unique Feathers system that allows Chyrp to be whatever you want it to be. You can post anything and everything, or just stick to the default Text feather and run a regular blog. Chyrp destroys the fine line between a blog and a tumblelog.

Requirements

Chyrp will thrive on virtually any server setup, but we guarantee Chyrp to run on no less than:

  • PHP 5 >= 5.1.0
  • PDO and PDO_MYSQL -OR- PDO and PDO_SQLITE
  • DateTime installed (PHP 5.1.x marks it as experimental and you need to enable it, but 5.2.x should have it by default.)
  • MySQL 4.1 -OR- SQLite 3
  • Apache 1.3.3

These requirements are more of guidelines, as these are the earliest versions of the services that we have tested Chyrp on. If you are successfully running Chyrp on an earlier version of these services, let us know.

Installation

Installing Chyrp is easier than you expect. You can do it in four steps:

  1. If using MySQL, Create a MySQL database with a username and password.
  2. Download, unzip, and upload.
  3. Open your web browser and navigate to where you uploaded Chyrp.
  4. Follow through the installer.

That's it! Chyrp will be up and running and ready to do your bidding.

Upgrading

Keeping Chyrp up to date is important to make sure that your blog is as safe as possible.

  1. Download the latest version of Chyrp from http://chyrp.net/.
  2. Overwrite your current Chyrp installation files (be sure to back up /themes, /modules, and /feathers) with the new ones.
  3. Upgrade by navigating to upgrade.php.
  4. Restore any backups you made.

Upgrading from 1.1.x

Upgrading from 1.1.x is only available for the first 2.0 release.

  1. Overwrite your old upgrade.php with the one included in the 2.0 package.
  2. Upgrade by navigating to upgrade.php.
  3. Follow its directions.

Extensions

Chyrp isn't complete without activating a few extensions. Extensions add functionality (ex. audio clips, video, photos) to Chyrp. You can find extensions for Chyrp made by the Chyrp community at http://chyrp.net/extend.

Installing Extensions

To install extensions, you have to determine what type of extension it is. It can be a module, a feather, a theme, or a localization. There's a different setup process for each type.

Feathers

Feathers add new post types to Chyrp. Post types determine what kind of media you can display in your blog.

  1. Download and unzip the feather
  2. Upload the feather to the feathers/ folder.
  3. Open your web browser and navigate to your Chyrp administration panel.
  4. Click on the Extend tab, and then the Feathers sub tab.
  5. Click the enable link beside the feather you just uploaded.

You can now use the feather by navigating to the Write tab and choosing the feather you uploaded.

Modules

Installing modules is quick, easy, and painless with Chyrp. They add extra functionality to Chyrp.

  1. Download and unzip the module.
  2. Upload the module to the modules/ folder.
  3. Open your web browser and navigate to your Chyrp administration panel.
  4. Click on the Extend tab and click the enable link beside the module you just uploaded.

The module is now installed and is ready for action. Keep in mind that some modules may conflict with each other if they do similar tasks.

Themes

Chyrp makes applying themes to your blog easy. With a single click you can change the look of your blog.

  1. Download and unzip the theme.
  2. Upload the theme to the themes/ folder. Make sure that it is contained in it's own folder.
  3. Open your web browser and navigate to your Chyrp administration panel.
  4. Click on the Extend tab, and then the Themes sub tab.
  5. Click on the screenshot of the theme you just uploaded to apply it to your blog.

Chyrp can even show you what the theme will look like before anyone else sees it. In the Themes sub tab, click on the Preview button below the theme screenshot to see the theme.

Localization

Chyrp is multilingual! If your first language isn't English, you can apply a new localization to Chyrp to make it speak your language.

  1. Download and unzip the localization.
  2. Upload the .mo file to the includes/locale/ folder. You don't need anything else for the translation to work.
  3. Open your web browser and navigate to your Chyrp administration panel.
  4. Click on the Settings tab, and change the Language option to the language you just uploaded.

Chyrp is in need of people like you to help localize Chyrp to your language.