原始碼

[[Category:Plugins]]
__NOTOC__

'''名稱'''： 文章置頂及公告

'''版本'''： 1.0

'''下載連結'''： http://prdownloads.sourceforge.net/lifetype/stickyposts.zip?download

'''程式授權'''： GPL

'''作者'''： lss

= 用途 =

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

= 設定 =

後台管理部份：

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

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

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

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

樣版檔範例：

這是一個非常簡單的樣版檔範例，用來展示 Sticky Posts Plugin 的用法。它是以 'blueish' 樣版為例做修改。
<smarty>
{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>
{/if}  
  {foreach from=$posts item=post}
    {include file="$blogtemplate/post.template"}
  {/foreach}
</div>
{include file="$blogtemplate/panel.template"}
{include file="$blogtemplate/footer.template"}
</smarty>

如果只要在首頁顯示置頂文章與最新消息，只要在相關的樣版程式碼：(第 3 行的'''{if $stickyposts->isEnabled()}'''到倒數第 6 行的'''{/if}''')前後加上 $showAll 變數的判斷即可。
<smarty>
{if empty($showAll)}
{if $stickyposts->isEnabled()}
.....
{/if}
{/if}
</smarty>

= 注意事項 =

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

'''2005-05-18 更新：'''上面的範例倒數第 6 行少了一個'''{/if}'''，已更正。

'''2005-05-18 更新：'''加入只在首頁顯示置頂與最新消息的方法。

= 其他範例 =

這裡有一個使用stickyposts實作「[[Previous_Next_in_Same_Category|在單篇彙整頁面中顯示同類別上下篇連結]]」的範例