citysite 城市站點
[基礎(chǔ)用法]
標(biāo)簽：citysite
name值：web_citysite_open
描述：易優(yōu)多城市站點常用標(biāo)記，可以循環(huán)嵌套標(biāo)簽。通常用于多城市站點以獲取站點列表信息，方便實現(xiàn)站群與分站的網(wǎng)站。
注意事項：
1、專業(yè)版授權(quán)才支持，點擊查看如何開啟多城市站點
2、對于早期不能升級的多城市網(wǎng)站，查看后臺版本號，如果是v100.5.4，請通過FTP編輯 data/conf/version.txt 文件，將 v100.5.4 改為 v1.5.4，就可以在線升級；
注意事項：
1、專業(yè)版授權(quán)才支持，點擊查看如何開啟多城市站點
2、對于早期不能升級的多城市網(wǎng)站，查看后臺版本號，如果是v100.5.4，請通過FTP編輯 data/conf/version.txt 文件，將 v100.5.4 改為 v1.5.4，就可以在線升級；
用法：
用法與標(biāo)簽channel相似
用法與標(biāo)簽channel相似
{eyou:citysite type='top' loop='8' currentclass='active'}
<li class="{$field.currentclass}"><a href='{$field.siteurl}'>{$field.name}</a> </li>
{/eyou:citysite}
屬性：
type='son' 表示下級城市站點
------ type='self' 表示同級城市站點
------ type='top' 表示頂級城市站點
------ type='sonself' 表示當(dāng)前下級城市站點以及同級城市站點
------ type='first' 表示當(dāng)前城市站點ID的最頂級城市站點下的第一級全部城市站點
loop='10' 返回城市站點列表總數(shù)（建議不要與limit屬性同時存在，否則loop無效）
limit='起始ID,記錄數(shù)' （起始ID從0開始）表示限定的記錄范圍（如：limit='1,2' 表示從ID為1的記錄開始，取2條記錄）
titlelen='30' 城市站點名稱長度
currentclass='' 應(yīng)用樣式class類名
siteid='' 城市站點ID
notypeid='' 同siteid，但這里是表示不包含這些城市站點ID，與siteid不能同時存在；
offset='0' 記錄的起始ID，默認(rèn)從0開始，假如指定2，將過濾最前面的2條，從第三條顯示
notypeid='' 同siteid，但這里是表示不包含這些城市站點ID，與siteid不能同時存在；
offset='0' 記錄的起始ID，默認(rèn)從0開始，假如指定2，將過濾最前面的2條，從第三條顯示
name='' 數(shù)組類型的變量名（二、三級城市站點時才用到）
empty='' 沒有數(shù)據(jù)時顯示的文案
mod='' 每隔N行輸出的內(nèi)容
id='' 可以任意指定循環(huán)里的變量名替代field，假設(shè)id='field1'，模板調(diào)用如：{$field.name} 變成 {$field1.name}
涉及表字段：
請查閱易優(yōu)數(shù)據(jù)字典，找到表名 ey_citysite
獲取當(dāng)前城市名稱
{$eyou.site.name} 當(dāng)前城市名稱
{$eyou.site.seo_title} 當(dāng)前城市SEO標(biāo)題
{$eyou.site.seo_keywords} 當(dāng)前城市SEO關(guān)鍵詞
{$eyou.site.seo_description} 當(dāng)前城市SEO描述
{$eyou.site.name|default='全國'} 如果沒有選擇城市則顯示全國
標(biāo)簽說明：此標(biāo)簽可以在單獨使用，也可在其他標(biāo)簽內(nèi)套用
分站點統(tǒng)一首頁的SEO標(biāo)簽調(diào)法：
{eyou:global name='web_title' /} 城市的SEO標(biāo)題
{eyou:global name='web_keywords' /} 城市的SEO關(guān)鍵詞
{eyou:global name='web_description' /} 城市的SEO描述
獲取當(dāng)前城市名稱
{$eyou.site.name} 當(dāng)前城市名稱
{$eyou.site.seo_title} 當(dāng)前城市SEO標(biāo)題
{$eyou.site.seo_keywords} 當(dāng)前城市SEO關(guān)鍵詞
{$eyou.site.seo_description} 當(dāng)前城市SEO描述
{$eyou.site.name|default='全國'} 如果沒有選擇城市則顯示全國
標(biāo)簽說明：此標(biāo)簽可以在單獨使用，也可在其他標(biāo)簽內(nèi)套用
-------------------------------示例展示--------------------------------
{eyou:list loop='10'}
<li><a href="{$field.arcurl}">{$eyou.site.name}{$field.title}</a></li>
{/eyou:list}
-------------------------------示例展示--------------------------------
1，調(diào)用頂級多城市站點
模板調(diào)用代碼
{eyou:citysite type="top" loop="8" id="field" currentclass="on"}
<li> <a class="{$field.currentclass}" href="{$field.siteurl}">{$field.name}</a> </li>
{/eyou:citysite}
網(wǎng)站前端顯示效果（css樣式請自行填充）
2.當(dāng)前城市站點下子城市站點調(diào)用
模板調(diào)用代碼
{eyou:citysite siteid="城市站點ID" loop="6" type ='son' currentclass="on"}
<li class="{$field.currentclass}"><a href="{$field.siteurl}" >{$field.name}</a> </li>
{/eyou:citysite}
網(wǎng)站前端顯示效果（css樣式請自行填充）
【更多示例】
-------------------------------示例1--------------------------------
描述：輸出最頂級城市站點，不包括子孫站點，可用于網(wǎng)站簡單的一級城市站點
{eyou:citysite type="top" loop="10" currentclass="active"}
<a href="{$field.siteurl}" class="{$field.currentclass}">{$field.name}</a>
{/eyou:citysite}
-------------------------------示例2--------------------------------
描述：輸出二個層級城市站點（這里用到citysite標(biāo)簽層次嵌套，注意屬性id | name的用法）
{eyou:citysite type='top' loop='10' id='field1' currentclass='active'} // 第一級城市站點循環(huán)開始
<li>
<a href="{$field1.siteurl}" class="{$field1.currentclass}">
{$field1.name}
{eyou:notempty name='$field1.children'} // 判斷是否有子站點（該示例指的是第二級城市站點）
有子站點時才顯示這里的html代碼，比如：箭頭、圖標(biāo)等
{/eyou:notempty}
</a>
{eyou:notempty name='$field1.children'} // 判斷是否有子站點（該示例指的是第二級城市站點）
<div>
{eyou:citysite name='$field1.children' id='field2' loop='10'} // 第二級城市站點循環(huán)開始
<a href="{$field2.siteurl}" class="dropdown-item ">{$field2.name}</a>
{/eyou:citysite} // 第二級城市站點循環(huán)結(jié)束
</div>
{/eyou:notempty}
</li>
{/eyou:citysite} // 第一級城市站點循環(huán)結(jié)束
-------------------------------示例3--------------------------------
描述：輸出復(fù)雜的三個層級城市站點（這里用到citysite標(biāo)簽層次嵌套，注意屬性id | name的用法）
{eyou:citysite type='top' loop='10' id='field1' currentclass='active'} // 第一級城市站點循環(huán)開始
<li>
<a href="{$field1.siteurl}" class="{$field1.currentclass}">
{$field1.name}
{eyou:notempty name='$field1.children'}
有子城市站點時才顯示這里的html代碼，比如：箭頭、圖標(biāo)等
{/eyou:notempty}
</a>
{eyou:notempty name='$field1.children'} // 判斷是否有子城市站點（第二級城市站點）start
<div>
{eyou:channel name='$field1.children' id='field2' loop='10'} //第二級城市站點循環(huán)開始
<div>
<a href="{$field2.siteurl}" class="dropdown-item ">{$field2.name}</a>
{eyou:notempty name='$field2.children'} // 判斷是否有子城市站點（第三級城市站點）start
<div class="dropdown-menu animate">
{eyou:citysite name='$field2.children' id='field3' loop='10'} //第三級城市站點循環(huán)開始
<a href="{$field3.siteurl}" class="dropdown-item ">{$field3.name}</a>
{/eyou:citysite} //第三級城市站點循環(huán)結(jié)束
</div>
{/eyou:notempty} // 判斷是否有子城市站點（第三級城市站點）end
</div>
{/eyou:channel} // 第二級城市站點循環(huán)結(jié)束
</div>
{/eyou:notempty} // 判斷是否有子城市站點（第二級城市站點）end
</li>
{/eyou:citysite} //第一級城市站點循環(huán)結(jié)束
-------------------------------示例4--------------------------------
描述：每隔3條輸出文檔記錄
{eyou:citysite type='top' loop='10' mod='3'}
{eyou:eq name='mod' value='0'}
<a href='{$field.siteurl}'>{$field.name}</a>
{/eyou:eq}
{/eyou:citysite}
-------------------------------示例5--------------------------------
描述：mod屬性還用于控制一定記錄的換行，每3條記錄換行一次
{eyou:citysite type='top' loop='10' mod='3'}
<a href='{$field.siteurl}'>{$field.name}</a>
{eyou:eq name='mod' value='0'}
<br/>
{/eyou:eq}
{/eyou:citysite}
-------------------------------示例6--------------------------------
描述：輸出指定起始ID的記錄，過濾最前面2條，從第三條開始輸出
{eyou:citysite type='top' offset='2'}
<a href='{$field.siteurl}'>{$field.name}</a>
{/eyou:citysite}
-------------------------------示例7--------------------------------
描述：內(nèi)置變量輸出數(shù)據(jù)索引與記錄順序，key 表示索引，默認(rèn)從0開始；i 表示順序，默認(rèn)從1開始。
{eyou:citysite type='top'}
{$key} - {$i}
{/eyou:citysite}
效果：
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5
-------------------------------示例8--------------------------------
描述：自定義變量名
{eyou:citysite type='top' id='field2'}
<a href='{$field2.siteurl}'>{$field2.name}</a>
{/eyou:citysite}
-------------------------------示例9--------------------------------
描述：判斷前端多城市切換按鈕隨著后臺開啟/關(guān)閉則顯示/隱藏
{notempty name="$eyou.global.web_citysite_open"}
<a href="javascript:city_tc('多城市');">{$eyou.site.name|default='全國'}<i></i></a>
{/notempty}
文檔最后更新時間：2023-10-23 17:07:20