PLog 1.0/Plugins/stickyposts
From PLog 中文文件計畫

名稱： 文章置頂及公告
版本： 1.0
下載連結： http://sourceforge.net/project/plog/xxx
程式授權： GPL
作者： lss

用途

提供網誌做文章置頂及用文章做為網站公告。

設定

後台管理部份：

   1. 首先請建立兩個文章分類存放公告及置頂文章。
   2. 你可以在 個人網誌設定 >> 置頂及公告文章設定 進行各項設定。
   3. 預設的置頂文章數目及公告文章數目是 5 篇文章，你可以修改成你要顯示的數目。
   4. 在選單中選擇存放置頂文章及公告文章的分類。 

在樣版檔案裡，你可以使用：

   1. $stickyposts->isEnabled() 檢查 plugin 是否已經啟用。
   2. $stickyposts->getArticles( 'sticky' ) 傳回置頂文章的 article 陣列，最多傳回所設定的置頂文章數目。
   3. $stickyposts->getArticles( 'announce' ) 傳回公告文章的 article 陣列，最多傳回所設定的公告文章數目。
   4. $stickyposts->getArticles( 12 ) 傳回指定文章分類 ID 的所有文章 article 陣列。本例中的 12 為文章分類 ID。
   5. $stickyposts->getCategory( 'sticky' ) 傳回用於置頂文章的 category 物件，可用來做成更多置頂文章超連結。
   6. $stickyposts->getCategory( 'announce' ) 傳回用於公告文章的 category 物件，可用來做成更多公告文章超連結。
   7. $stickyposts->getCategory( 12 ) 傳回指定文章分類 ID 的 category 物件。 

其中 'sticky' 和 'announce' 是 plugin 的保留字。

樣版檔範例：

這是一個非常簡單的樣版檔範例，用來展示 Sticky Posts Plugin 的用法。它是以 'blueish' 樣版為例做修改。

{include file="$blogtemplate/header.template"}
<div id="content">
{if $stickyposts->isEnabled()}
  <h2>Sticky Posts</h2>
  {assign var=stickys value=$stickyposts->getArticles('sticky')}
  {foreach from=$stickys item=post}
      <h2 class="title"><a href="{$url->postPermalink($post)}">{$post->getTopic()}</a></h2>
  {/foreach}
  {assign var=stickyCategory value=$stickyposts->getCategory('sticky')}
  <h4><a href="{$url->categoryLink($stickyCategory)}">more sticky posts</a></h4>
  
  <h2>Announce Posts</h2>
  {assign var=stickys value=$stickyposts->getArticles('announce')}
  {foreach from=$stickys item=post}
      <h2 class="title"><a href="{$url->postPermalink($post)}">{$post->getTopic()}</a></h2>
  {/foreach}
  {assign var=announceCategory value=$stickyposts->getCategory('announce')}
  <h4><a href="{$url->categoryLink($announceCategory)}">more announce posts</a></h4>
  
  {foreach from=$posts item=post}
    {include file="$blogtemplate/post.template"}
  {/foreach}
{/if}
</div>
{include file="$blogtemplate/panel.template"}
{include file="$blogtemplate/footer.template"}


注意事項

上面的樣版檔範例是一個很差的範例，請樣版高手製作又好又漂亮的樣版，並請隨手將這個範例換掉。


取自"http://wiki.plogworld.org.tw/index.php/PLog_1.0/Plugins/stickyposts"

頁面分類: Plugins