How can I fix this so I can use images in my blog items?"

Solution:
The permissions on the /media/ must be set to either 775 or 777. You can do this through an FTP client or your web host's file manager interface. Simply navigate to the directory in which you installed Nucleus, select your /media/ directory and change the permissions accordingly.

Figure 1: Right-clicking on the /media/ directory and selecting "Properties" in the Core FTP FTP client brings up this dialogue box for you to set permissions.

Original forum thread (thanks, Armon!):
http://forum.nucleuscms.org/viewtopic.php?t=16458

Original forum thread:
http://forum.nucleuscms.org/viewtopic.php?t=16159

Solution:
Most web hosts will have a user control panel installed on their server (such as cpanel) which will allow you to upload files to your server using your browser. This can be very time consuming if you have many files to upload, such as if you are adding a new skin to your site! The easiest way to upload a new skin is to use an FTP client.

There are many good FTP clients available which you can download and install for free if you do not already have an FTP client:

Windows

• Core FTP Lite Edition (freeware)
• FileZilla (opensource)

Method:

1. Download the skin you want to use from the Nucleus CMS Skins Site. Your download will be a single .zip file which contains a single folder named after the skin. We will be using the Enlight skin as an example, so our .zip file will be called enlight_skin.zip and it will contain a single folder called enlight.
2. Locate your downloaded skin .zip file on your computer.

3. Using an archive extracting program, unzip the skin folder from the .zip file. If available, choose the "Extract Here" option.

4. Find the skin folder which has been extracted. Some archive extracting programs will not have the "Extract Here" option and will save the unzipped folders and files in a folder with the same name as the .zip file. So in our example, you may have the /enlight/ folder inside another folder called /enlight_skin/. Only the /enlight/ folder will be uploaded.

   Check to see the folder appears to be complete. It should have at minimum the readme.html, preview.png, preview-large.png and skinbackup.xml files.

5. Open your FTP client and connect to your server. Navigate to your /skins/ directory (it should be in the same place as your index.php in the directory where you installed Nucleus). Browse to find and select your entire skin folder in your FTP client. Once you have done this, click to upload the entire folder to the /skins/ directory.

6. Wait for your files to upload...

7. When the entire skin folder has uploaded, you should see it in your /skins/ directory like this:

8. Now you can import your new skin!

Further reading:

• How do I import a skin?
• What is the password to the .zip files for Nucleus skins?
• How can I change the skin for my blog/site?
• I just imported a skin but when I try to use it, no images, formatting, css or styles show on my page!

Solution:
The easy solution is to install one of the following plugins:

• NP_FancyText.php
• NP_TinyMCE2.php

If you do not wish to install a plugin for some reason, you can employ a core hack to put some basic formatting toolbar icons into your Add Comment area.

Original forum thread (thanks, maxirmx!):
http://forum.nucleuscms.org/viewtopic.php?t=15975

Method:

WARNING: BEFORE TRYING ANY CORE HACK, YOU SHOULD ALWAYS MAKE A COMPLETE BACKUP OF YOUR NUCLEUS INSTALLATION!!!

1. Add the following code to all stylesheets in use on your site (you can usually find them in the /skins/skinname/ directory):
   

   /* markup buttons */
   .jsbutton
   {
       text-align: center;
       padding: 3px;
       border: 1px solid #dddddd;
   }
    
   .jsbuttonspacer
   {
       padding-right: 10px;
   }
    
   .jsbuttonbar
   {
       padding: 3px;
       cursor: default;
   }

2. Open up the commentform-loggedin.template file in the /nucleus/forms/ directory and replace its contents with the following code:
   

   <script type="text/javascript"
       src="<%adminurl%>javascript/edit.js">
   </script>
   
   <a id="nucleus_cf"></a>
   <form method="post" action="#nucleus_cf">
     <div class="commentform">
        <%errordiv%>
   
      <input type="hidden" name="action" value="addcomment" />
      <input type="hidden" name="url" value="<%formdata(destinationurl)%>" />
      <input type="hidden" name="itemid" value="<%itemid%>" />
      <label for="inputbody"><%text(_COMMENTFORM_COMMENT)%></label>:
   <div class="jsbuttonbar">
            <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="boldThis()" >         
                  <img src="<%adminurl%>images/button-bold.gif" alt="" width="16" height="16"/>
           </span>            
           <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="italicThis()" >         
                  <img src="<%adminurl%>images/button-italic.gif" alt="" width="16" height="16"/>
            </span>            
            <span class="jsbuttonspacer">
            </span>         
            <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="ahrefThis()" >         
                  <img src="<%adminurl%>images/button-link.gif" alt="" width="16" height="16"/>
            </span>            
           </div>
   
      <textarea name="body" class="formfield" tabindex="10" cols="40" rows="10" id="inputbody"
      onkeyup="storeCaret(this);"
      onclick="storeCaret(this);"
      onselect="storeCaret(this);">
      <%formdata(body)%> </textarea>
   
   
      <%text(_COMMENTFORM_YOUARE)%> <%formdata(membername)%>
      <small>(<a href="?action=logout"><%text(_LOGOUT)%></a>)</small>
   
   
      <input type="submit" value="<%text(_COMMENTFORM_SUBMIT)%>" class="formbutton" />
      <%callback(FormExtra,commentform-loggedin)%>   
     </div>
   </form>
   

3. Next, replace the contents of the commentform-notloggedin.template file in the same /nucleus/forms/ directory with this code:
   

   <script type="text/javascript"
       src="<%adminurl%>javascript/edit.js">
   </script>
   
   <a id="nucleus_cf"></a>
   <form method="post" action="#nucleus_cf">
     <div class="commentform">
        <%errordiv%>
   
      <input type="hidden" name="action" value="addcomment" />
      <input type="hidden" name="url" value="<%formdata(destinationurl)%>" />
      <input type="hidden" name="itemid" value="<%itemid%>" />
      <label for="inputbody"><%text(_COMMENTFORM_COMMENT)%></label>:
   <div class="jsbuttonbar">
            <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="boldThis()" >         
                  <img src="<%adminurl%>images/button-bold.gif" alt="" width="16" height="16"/>
           </span>            
           <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="italicThis()" >         
                  <img src="<%adminurl%>images/button-italic.gif" alt="" width="16" height="16"/>
            </span>            
            <span class="jsbuttonspacer">
            </span>         
            <span class="jsbutton"
                  onmouseover="BtnHighlight(this);"
                  onmouseout="BtnNormal(this);"
                  onclick="ahrefThis()" >         
                  <img src="<%adminurl%>images/button-link.gif" alt="" width="16" height="16"/>
            </span>            
           </div>
   
      <textarea name="body" class="formfield" tabindex="10" cols="40" rows="10" id="inputbody"
      onkeyup="storeCaret(this);"
      onclick="storeCaret(this);"
      onselect="storeCaret(this);">
      <%formdata(body)%> </textarea>
   
   
      <label for="nucleus_cf_name"><%text(_COMMENTFORM_NAME)%></label>: <input name="user" size="40" maxlength="40" value="<%formdata(user)%>" class="formfield" id="nucleus_cf_name" />
   
   
      <label for="nucleus_cf_mail"><%text(_COMMENTFORM_MAIL)%></label>: <input name="userid" size="40" maxlength="60" value="<%formdata(userid)%>" class="formfield" id="nucleus_cf_mail" />
   
      <%callback(FormExtra,commentform-notloggedin)%>   
   
      <input type="checkbox" value="1" name="remember" id="nucleus_cf_remember" <%formdata(rememberchecked)%> /><label for="nucleus_cf_remember"><%text(_COMMENTFORM_REMEMBER)%></label>
   
   
      <input type="submit" value="<%text(_COMMENTFORM_SUBMIT)%>" class="formbutton" />
     </div>
   </form>
   

4. Now open up the COMMENTS.php file inside the /nucleus/libs/ directory and find this bit of code:
   

      // prepares the body of a comment (static)
      function prepareBody($body) {
    
         // remove newlines when too many in a row
         $body = ereg_replace("\n.\n.\n","\n",$body);
    
         // encode special characters as entities
         $body = htmlspecialchars($body);
    
         // trim away whitespace and newlines at beginning and end
         $body = trim($body);
    
         // add  tags
         $body = addBreaks($body);
    
         // create hyperlinks for http:// addresses
         // there's a testcase for this in /build/testcases/urllinking.txt
         $replaceFrom = array(
            '/([^:\/\/\w]|^)((https:\/\/)([\w\.-]+)([\/\w+\.~%&?@=_:;#,-]+))/ie',
            '/([^:\/\/\w]|^)((http:\/\/|www\.)([\w\.-]+)([\/\w+\.~%&?@=_:;#,-]+))/ie',
            '/([^:\/\/\w]|^)((ftp:\/\/|ftp\.)([\w\.-]+)([\/\w+\.~%&?@=_:;#,-]+))/ie',
            '/([^:\/\/\w]|^)(mailto:(([a-zA-Z\@\%\.\-\+_])+))/ie'
         );
         $replaceTo = array(
            'COMMENT::createLinkCode("\\1", "\\2","https")',
            'COMMENT::createLinkCode("\\1", "\\2","http")',
            'COMMENT::createLinkCode("\\1", "\\2","ftp")',
            'COMMENT::createLinkCode("\\1", "\\3","mailto")'
         );
         $body = preg_replace($replaceFrom, $replaceTo, $body);
    
         return $body;
      }

5. Replace the above section of code with this code:
   

      // prepares the body of a comment (static)
      function prepareBody($body) {
    
         // remove newlines when too many in a row
         $body = ereg_replace("\n.\n.\n","\n",$body);
    
    
   // sooz [?]      
   //                $body = addslashes ($body);
    
    
         // trim away whitespace and newlines at beginning and end
         $body = trim($body);
    
         // add  tags
         $body = addBreaks($body);
    
         return $body;
      }

6. You should now see three icons in your Add Comment area for Bold, Italics and Links.

Solution:
You can manually link your text like this:

<a href="http://reallycoolwebsite.com/">really cool website</a>

You can also use the toolbar editor in the Nucleus admin area. First, select the text you want to make into a link, then click on the link icon (the one with the little globe and chain):

Next, type the URL of your link and press "OK":

All done! You should end up with something like this:

Original forum thread (thanks, Leng!):
http://forum.nucleuscms.org/viewtopic.php?t=15176

Solution:
Create a new template called "headlines" which contains the following code in the Item Header section:

<li><a href="<%itemlink%>" title="<%title%>"><%title%></a></li>

Then place this code where you want your list to appear:

<ul>
<%otherblog(blogname,headlines,X,categoryname)%>
</ul>

where blogname is the name of your blog, templatename is the name of your headline template to show just the linked item titles and categoryname is the name of your category.

Original forum thread (thanks, Leng!):
http://forum.nucleuscms.org/viewtopic.php?t=14468

Solution:
Nucleus has a variety of plugins which make sticky items possible:

• NP_ShowBlogs.php
• NP_Ordered.php
• NP_Sticky.php
• NP_StickyItem.php

Original forum thread (thanks, ftruscot!):
http://forum.nucleuscms.org/viewtopic.php?t=16049

Solution:

1. Check that you have uploaded everything in the skins package you have downloaded, especially any image files or .css files. Note that you must upload everything exactly as it is in the skin folder (i.e. /skinname/) to the /skins/ directory. For example, if you are trying to install the Libra skin, make sure you have uploaded the entire /libra/ folder, not just everything in the folder.
2. View the source of your page in your browser [ In Firefox: View > Page Source (Ctrl + U); in Internet Explorer 6: View > Source; in Internet Explorer 7: Page > Source ] and check that the URL your browser is accessing for the .css file is where the file actually is! For example, the .css file for the official Nucleus CMS website is at http://nucleuscms.org/styles/skins/nucleus/style.css. If your .css file is being called from http://yourdomain.com/directory/style.css, check there actually is a file called style.css in the directory /directory/.
3. Check that when you have unzipped the skin package (skinname_skin.zip) you have only uploaded the folder skinname. Some unzipping software will unzip the skin package into a folder with the same name as the skin package (e.g. skinname_skin with a subfolder skinname). Do not upload this folder! Open the folder and upload the folder skinname inside the first folder.

Original forum thread (thanks, echinacea!):
http://forum.nucleuscms.org/viewtopic.php?t=15880

Solution:
There are actually multiple ways of having static pages or extra pages in Nucleus:

1. Download the Nucleus v3.3 Release Candidate, which has added custom skin parts (allows static pages)
2. If you don't like the idea of installing a version of Nucleus which is not a final release, you can follow this thread to just add the custom skin parts yourself:
   Hack: Custom skinparts, for static content, custom displays
3. There is also utterplush's somewhat messy but functional method which is tried and true:
   How do I use Nucleus to manage my static content?
4. If that is all too complicated, you can make static pages using a simple .txt file:
   Can I use text (.txt) files to create static pages in Nucleus?
5. Finally, there is always the option of installing some plugins:
   • NP_Dino.php
   • NP_Static (this plugin is experimental)
   • NP_ExtraSkinJP (see the translated English documentation)
   • NP_ExtraSkin (author no longer using Nucleus)

Original forum thread (thanks, Armon, Leng!):
http://forum.nucleuscms.org/viewtopic.php?t=15412

]]> Getting started http://faq.nucleuscms.org/index.php?itemid=198 Sun, 24 Jun 2007 03:32:58 +0200 http://faq.nucleuscms.org/index.php?itemid=80 Written and contributed by Leng Lui.

Scenario:
"I think Nucleus is really great and I want to use it for my site/blogging community. How do I install it?"

Solution:
Just follow this walkthrough and you'll have Nucleus up and running in no time! All you'll need is

• a server which meets the minimum requirements for PHP and MySQL;
• a utility program which can open .zip files, such as 7-Zip (opensource), WinRAR (shareware) or WinZip (shareware); and
• an FTP program (optional, but preferably due to the number of files that must be uploaded to the server) such as Core FTP (freeware version available) or FileZilla (opensource).

If you are looking to install Nucleus on your local hard drive, it is recommended you follow the FAQ article "Can I run Nucleus offline from my local computer/hard drive without being online?" prior to this FAQ article.

Contents:

• Walkthrough
• Further reading

For those who would like to see a little more action, here's karma's very own interactive Nucleus installation walkthrough:

• Karma's Interactive Nucleus Installation Walkthrough

Walkthrough:

1. Download the latest version of Nucleus from the Nucleus site. At the time of writing this walkthrough, the latest version is 3.2.

   Save the .zip file to your computer.

2. Extract the files from the .zip. All the Nucleus files have been zipped inside a folder called nucleus 3.2. Open the folder and you should have something like this:

3. Open up your FTP client and connect to your server. Navigate to your /public_html/ folder on your server (circled in red) and your \nucleus 3.2\ folder on your hard drive (circled in green). Here you can choose whether you want to install Nucleus in your top directory (http://yoursite.com/) or a subdirectory (http://yoursite.com/subdirectory/). Since I'm already running a Nucleus installation in my top directory, I'm going to install Nucleus in a subdirectory called /testing/.

   Upload all the files in the \nucleus 3.2\ folder to the directory you want to install Nucleus in. In my case, I've uploaded all my files to /public_html/testing/ (area in blue square).

4. Next, we'll have to create a MySQL database for Nucleus to use. Login to your server's administration area. For this tutorial, we'll be using the Cpanel interface. Ensim users, please see the Ensim Database Installation Walkthrough.

   Go into the MySQL databases admin area (circled in red).

5. Scroll down until you find the part which allows you to add a database (circled in red). Give your database a name and add it. I'm going to call mine ncls1.

6. Great, we now have a database! But there's no use having a database if nobody can access it. Scroll down again to create a new user for the database. My database user is going to be "ncls1" with a password of "password".

   You should get some sort of confirmation to let you know you've done it right.

7. The last part of setting up the MySQL database is adding the user to the database's access list (circled in red). Select the user and database you want to pair up. I will be adding lenglui_ncls1 to lenglui_ncls1. Make sure you give your user all privileges.

   Again, you should be taken to a confirmation screen:

   Your MySQL admin screen should now look like this:

8. Now it's time to run the install script! To do this, head to http://yoursite.com/install.php, where yoursite.com is the URL to your site. But if you've installed in a subdirectory like me, you'll need to go to http://yoursite.com/subdirectory/install.php where subdirectory is the name of the subdirectory you uploaded your Nucleus files to. Since I installed Nucleus in the /testing/ subdirectory, I need to go to http://leng-lui.info/testing/install.php".

   You should arrive a page that looks something like this:

9. Enter in your MySQL login details. Remember the MySQL database and user you created earlier? This is where the information goes. Your hostname will usually be localhost. Mine looks like this:

10. Nucleus should automatically detect your directories and paths for you. Just check to see that they're the correct absolute paths for your server (if you get a "The path of the administration area does not exist" error later, see this article). You should have something like this:

11. Next, enter the details for the administrator user and your default blog.

    Hit submit and go on to the final part.

12. So that Nucleus knows what your server paths and MySQL details are, copy/paste the information here to the config.php file in your \nucleus 3.2\ folder on your computer.

13. Switch back to your FTP program and upload the new config.php file to your server, overwriting the old file. Just a few more things to tidy up:

    Delete install.php and install.sql from your server (circled in red). Choose "Yes to all" (circled in blue).

Congratulations! You've just successfully installed Nucleus!

By default, Nucleus comes with one blog item already written. You can edit this item to really complete setting up your new Nucleus site.

1. Login to your Nucleus administration area located at http://yoursite.com/nucleus/ (or http://yoursite.com/subdirectory/nucleus/ if you installed in a subdirectory).

2. Click on "Edit/Delete Items" (circled in red).

3. Here, you'll see a list of all the items in your blog. At the moment, we only have that first default item. Click on the "Edit" link to edit the item.

4. Delete the text in the Body textarea as well as the Extended area. Change the title to whatever you want and write a little blurb to introduce your website.

5. Click on "Edit Item" to save your changes. This will take you back to the page listing all the items you have in your blog.

6. Click on the "Your site" link to visit your new Nucleus site, with welcome message and all.

Congratulations! You have just edited your first Nucleus item!

Further reading:
Now that you've installed Nucleus, you probably want to customize it to your own needs. Remember to check out the helpful articles in our "Getting started" section of this FAQ website and see our "Troubleshooting" section if something goes wrong!

To get you started, here are some links to the building blocks.

• What is the difference between a skin and a template?
• How do I change the look of my site?
• How do I import a skin?
• How do I install a plugin?
• How do I change the links in the default skin?
• How do I add/rename/delete categories?
• How do I add extra pages to my Nucleus site?
• Is there a basic user manual/guide for Nucleus?

If you have a question that has not been answered, come and ask us at our very friendly Nucleus Support Forum!

]]> Installation & Configuration http://faq.nucleuscms.org/index.php?itemid=80 Sun, 24 Jun 2007 03:29:00 +0200 http://faq.nucleuscms.org/index.php?itemid=197 Scenario:
"My blog item/RSS feed/other URL is located at http://www.domain.com/subdirectory/page.php by Nucleus keeps outputting http://www.domain.com/subdirectorypage.php instead!"

Solution:
Check under your "Global Settings" to ensure your site URL inside box "URL of Site (should end with a slash)" does really end with a slash!

If the above doesn't work and it is a problem with the links in your RSS feed, check your feeds/rss20 template. There should be a line that looks like this:

 
<link><%blogurl%>index.php?itemid=<%itemid%></link>

Try changing that line of code to:

 
<link><%blogurl%>/index.php?itemid=<%itemid%></link>

Original forum thread (thanks, roel!):
http://forum.nucleuscms.org/viewtopic.php?t=15221

]]> Troubleshooting http://faq.nucleuscms.org/index.php?itemid=197 Sun, 24 Jun 2007 03:09:05 +0200