Ultimate WordPress MultiSite, WP Multi Network, Atahualpa Mod

This is the Atahualpa Mod Version 2.0!

The Ultimate Multi Site Mod

This All New Version has many great features including…

1. It works for Single Sites and Multi Site Sites and WP Multi Network Sites.
2. It is a cleaner version that could be added into the core Atahualpa code (it breaks no functionality).
3. It allows automatic updates of Atahualpa (from WP), which will not delete custom image files. (Truly automatic if merged into the Atahualpa code.)
4. It uses standard WP functions to find the upload directory. So you do not need to do any of that. (Just upload the replacement files and you are done, all other mods are done in the WP Admin pages.)
5. It includes uploading ALL unique per-site graphics, the headers, the the logo and the favicon / per site.
6. It allows all files to be uploaded via the standard WP media uploader. Therefore different admins could only upload to the sites they are admin for as set by the Super Admin.
7. Once the Mod is made, no FTP access is needed to change images.
8. It keeps backward compatibility with WPMU (for anyone who may be using that function).
9. It allows Normal Default Settings for Atahualpa to function in a normal way. (Modified by the Admin Panel)
10. It allows Sort and Shuffle modes for Multi Site and Multi Network as well as Single site mode (these were never available in MPMU).

All in all it is a very nice mod, super easy to use, stable, and I hope it will be considered for permanent inclusion into the BytesForAll Code.

Building on Success!

After the success of these three posts…

• WordPress MultiSite, WP Multi Network, Atahualpa Theme, Easy Header Images
• WordPress Atahualpa Theme – Different Header Images for MultiSite WP
• Preventing WordPress Automatic Updates From Deleting Custom Settings (Themes and Plugins)

I decided to really take a look at this code and see what other problems I could fix, and how I could make this code even easier to you.  I then came up with the idea for the

The Ultimate Atahualpa Multi Site Mod

Installing the Multi Site Mod

Now is this Mod much more powerful than the last one, it is much easier to use!  In fact, easy as One, Two, Three!

Step 1 ~ Download

Download the zip file.

Username:  atahualpa
Password:  custom

Step 2 ~ Unzip

You know how to do that!

Step 3 ~ Upload

Just upload these files into your Atahualpa Theme directory on your server via FTP. (This is the only time you need FTP for a Multi Site or WP Multi Network Site.  All uploads of image files will be handled by the Media Uploader inside of WordPress.)

This Mod contains six files.

One File is added, namely:

• functions/bfa_ata_multisite.php

Four Files are modified, namely:

• functions/bfa_rotating_header_images.php
• functions/bfa_header_config.php
• header.php
• functions.php

One ReadMe File

This explains the whole mod including every modification and where they are.

• README_MULTISITE_MOD.php

The ReadMe file is for information only and does not need to be uploaded.

Configuring the Multi Site Mod

STEP 1

Upload Files to any Page or Post

Note: I suggest you use the ABOUT page!  This makes then easy to change later. However you can use any post, page or go straight to the media uploader.  The rest of this will assume we are using the About page to anchor our site images to.

From the About Page Click Upload/Image >> Add an Image

Upload all Headers, Logos and your Favicon in the same place makes it easy to maintain.  The Header Files and the Logo File MUST be in the same location.

TAKE NOTE of the “File URL” and copy it!

For this example case I will assume:  (But you must use what your WordPress gives you!)

FAVICON

• http://example.com/files/2011/02/rx.ico

Note: If you have problems uploading .ico type files, login as Super Admin, navigate to the “Super Admin” menu “Options” >> Upload Settings >> Upload file types >> and add “ico” to what is already there.

Example: jpg jpeg png gif ico

LOGO

• http://example.com/files/2011/02/Rx_symbol.png

ROTATING HEADERS

• http://example.com/files/2011/02/header_be_4.jpg
• http://example.com/files/2011/02/header_nice_1.jpg
• http://example.com/files/2011/02/header_good_2.jpg

Note: Important Rules For Header File Names…

1) Header files MUST begin with “header_”
2) Header files MUST NOT contain a dash (-)
3) Header files MUST NOT contain extra dots (.)

Note: The following are examples of WRONG file names…

header_be–4.jpg     ~ Contains a Dash
header_nice.1.jpg    ~ Contains extra Dot
header2good_2.jpg    ~ Does NOT start with “header_“

STEP 2

Rotating Header Files and Logo Examples

Insert into:

Atahualpa Theme Options >>

Style & edit HEADER AREA >>

Show Logo Image?

1) Custom Headers and Custom Logo

http://example.com/files/2011/02/Rx_symbol.png

In this case we have uploaded both a custom logo and one or more custom headers in the same folder.

From the Upload page we copied this…

http://example.com/files/2011/02/Rx_symbol.png

The part in blue tells the theme where to find the header files.

2) Custom Headers and DEFAULT Logo

/files/2011/02/logo.png

In this case we want to use our custom headers but the default logo, logo.png

One of our upload headers was…

http://example.com/files/2011/02/header_be_4.jpg

We use the part after the domain name and before the file name and add the default logo from the theme as shown in blue and brown above.

3) Custom Headers and NO Logo

/files/2011/02/

In this case we want to  use one or more custom headers, but we want NO logo at all.  Like in step two…

One of our upload headers was…

http://example.com/files/2011/02/header_be_4.jpg

We use the part after the domain name and before the file name  as shown in blue above.

4) DEFAULT Headers and Custom Logo

~http://example.com/files/2011/02/Rx_symbol.png

In this case we plan to use the default headers from the theme, but we want to use a Custom Logo.

This step is identical to step one, except we add a tilde “~” to the beginning to tell the theme to use the default headers instead.

5) DEFAULT Headers and DEFAULT Logo

logo.png

In this case we want to use the default headers and the default logo, just put in the default filename, logo.png

This is the standard startup for Atahualpa when it is first loaded.

6) DEFAULT Headers and NO Logo

(leave blank)

In this case we just want to configure our site to get rid of the default logo, and to use the default headers.  Just delete everything in the box and leave it blank.

STEP 3

FAVICON Examples

Insert into:

Atahualpa Theme Options >>

Overall Style & Config. >>

Add a FAVICON

1) Custom FAVICON

http://example.com/files/2011/02/rx.ico

In this case we have uploaded both a custom Favicon called rx.ico (or anything you want).

From the Upload page we copied this…

http://example.com/files/2011/02/rx.ico

This Favicon may actually be anywhere on the Internet that you have permission to use.  So the Favicon does not have to be in the same location as the Logo and Headers.

2) DEFAULT FAVICON

new-favicon.ico

In this cause we do NOT want to use a custom Favicon so we just leave it with the default value.  We may also wish to choose one of the other file names included in the Atahualpa Theme and insert that file name here.  This is the default setting.