src/web/app/themes/atahualpa/README.txt
author ymh <ymh.work@gmail.com>
Wed, 04 Dec 2019 11:40:06 +0100
changeset 0 505fe5249d9c
permissions -rw-r--r--
add foundations for pharmakon (bedrock + deploy)

Wordpress Theme "Atahualpa" 

VISIT THE SUPPORT FORUMS AT http://forum.bytesforall.com/

#####################################################################

UPGRADE:

#####################################################################

To manually upgrade the theme
-------------------------
1) download the new version of the theme
2) unzip the file
3) copy any images you have added in a prior release to the 'images/header' folder. If using a different folder this step is not needed. 
See the forums for directions.
4) if you have added any other files (templates, icons) copy them to the same folder in the new version - unless you are using the method to store them elsewhere. See the forums for directions.
5) Make sure the Atahualpa folder is named with the version number i.e atahualpa3712
6) upload the folder to the 'wordpress/wp-contents/themes' folder at your host
7) get on the backend of your site and go to Dashboard->Appearances->Themes and activate the new version
8) all done

You can now check out the new version. If something is wrong, you can simply go back to Dashboard->Appearances->Themes and re-activate the prior version.


#####################################################################

(First Time) INSTALLATION:

#####################################################################

1. Extract the file "atahualpaXXX.zip", "atahualpa.zip" or similar 
on your desktop computer, i.e. with WinZip or 7-zip

This will create a directory named atahualpa (or atahualpaXX) with many 
files and subdirectories. 

From now on we'll call this directory "atahualpa" although it might be 
"atahualpa3712" or whatever for you. 

#####################################################################

2. Upload the complete folder "atahualpa" with all its contents to
your web hosting account to the directory
/your wordpress-install/wp-content/themes/
so the final destination of the "atahualpa" folder becomes:
/your wordpress-install/wp-content/themes/atahualpa/
You will need a "FTP Client" Software for this

#####################################################################

3. Activate Atahualpa by clicking on its name or screenshot at:

Your Blog -> Site Admin -> Appearance -> Themes

If you have no "Site Admin" link anywhere on your blog, try
http://www.your-domain.com/wp-admin/
If you've installed WordPress in a subfolder such as "blog", it would
be http://www.your-domain.com/blog/wp-admin/

#####################################################################

4. Reload your blog homepage and see if the theme is active. If not, 
repeat the steps above or post at http://forum.bytesforall.com/

If it looks broken, it may be a matter of setting the theme options.
If the sidebars look empty, you may need to add widgets. 

#####################################################################

5. Configure the theme at

Your Blog -> Site Admin -> Appearance -> Atahualpa Theme Options

#####################################################################

6. The theme will automatically add 4 additional widgets to the list of available widgets:

BFA Recent Comments
An alternative to the default "Recent Comments" widget

BFA Popular Posts
Lists the posts with the most comments

BFA Popular in Cat
Lists the posts with the most comments, in the given category. Will only appear on category pages.

BFA Subscribe
Provides a Feedburner "Subscribe by Email" form, plus Posts and
Comments RSS links & buttons

A widget is a content block that you can drag and drop into one
of the sidebars. All widgets, the 4 BFA widgets and the default 
WordPress widgets, can be found at:

Your Blog -> Site Admin -> Appearance -> Widgets
 
#####################################################################

7. OPTIONAL: Install additional plugins to enhance your blog

Atahualpa should work with just about any plugin. Besides that it 
has improved plug & play support for these plugins:

WP-PageNavi
http://wordpress.org/extend/plugins/wp-pagenavi/

WP-Print
http://wordpress.org/extend/plugins/wp-print/

WP-Email
http://wordpress.org/extend/plugins/wp-email/

WP-PostViews
http://wordpress.org/extend/plugins/wp-postviews/

WP-PostRatings
http://wordpress.org/extend/plugins/wp-postratings/

Sociable
http://wordpress.org/extend/plugins/sociable/
Go to the settings page at Settings -> Sociable and 
uncheck all boxes in the sections "Position:" and "Use CSS:"

LMB^Box Comment Quicktags
http://wordpress.org/extend/plugins/lmbbox-comment-quicktags/

Optional: Edit lmbbox-comment-quicktags.php: 
1) To remove the link "Quicktags", delete the line 243
<a href="http://codex.wordpress.org/index.php/Write_Post_SubPanel#Quicktags" title="Help With Quicktags">Quicktags</a>:
2) To fix a not validating tag, change line 276 
<script type="text/javascript" language="javascript" src="<?php echo get_settings('siteurl'); ?>/wp-content/plugins/lmbbox-comment-quicktags.php"></script>
to
<script type="text/javascript" src="<?php echo get_settings('siteurl'); ?>/wp-content/plugins/lmbbox-comment-quicktags.php"></script>

Subscribe to Comments
http://wordpress.org/extend/plugins/subscribe-to-comments/

Paged Comments (not required in WP 2.7+ because paged comments are a core Wordpress feature now)
http://wordpress.org/extend/plugins/paged-comments/

CommentLuv
http://wordpress.org/extend/plugins/commentluv/

Get Recent Comments
http://wordpress.org/extend/plugins/get-recent-comments/


Additionally, Atahualpa has been tested with

Akismet
http://wordpress.org/extend/plugins/akismet/
(this plugin should already be available in your blog)
Also requires http://wordpress.com/api-keys/

WP Cache 2
http://wordpress.org/extend/plugins/wp-cache/
This is easier to install than WP Super Cache

WP Super Cache
http://wordpress.org/extend/plugins/wp-super-cache/
This requires that you use Permalinks

WP-Syntax
http://wordpress.org/extend/plugins/wp-syntax/

WPG2
http://wordpress.org/extend/plugins/wpg2/

Nextgen Gallery
http://wordpress.org/extend/plugins/nextgen-gallery/

Feedburner Feedsmith
http://www.google.com/support/feedburner/bin/answer.py?answer=78483&topic=13252

Should also work with
All in one SEO (many Atahualpa users are using it)
and other SEO plugins


- When you add CSS through "CSS Inserts" or other theme options: Absolute paths must be used, such as 
url(http://www.yoursite.com/wp-content/themes/atahualpa/images/myimage.gif).
A relative path such as url(images/myimage.gif) will NOT work in the theme options. 

#####################################################################


LICENSE:

    "Atahualpa" is a WordPress theme
    Copyright (C) 2008-2012 Lmm Muenchen, BFA Webdesign (www.BytesForAll.com)

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.