dede arclist标签row=10参数如何设置？

Of course! The dede:arclist tag is one of the most frequently used tags in DedeCMS (织梦CMS). It's used to display a list of articles, often on the homepage, category pages, or in sidebars.

The row attribute is essential for controlling how many articles appear in the list.

Basic Syntax and the row Attribute

The row attribute specifies the maximum number of articles to display in the list.

Basic Structure:

{dede:arclist row='10' titlelen='30' typeid=''}
    <li>
        <a href='[field:arcurl/]'>[field:title/]</a>
        <span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
    </li>
{/dede:arclist}

Explanation of the row='10' part:

• row: The attribute name.
• 10: The value, which means "show a maximum of 10 articles".
• DedeCMS will fetch the 10 most recently published articles (based on their sorting rules) and display them.

Complete Example: A List of 10 Latest Articles

Here is a practical example you can use on your homepage to show the 10 latest articles from all sections.

<h3>Latest Articles</h3>
<ul class="article-list">
    {dede:arclist row='10' titlelen='30' orderby='pubdate' orderway='desc'}
    <li>
        <span class="date">[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
        <a href="[field:arcurl/]" title="[field:title function='html2text(@me)'/]">[field:title/]</a>
    </li>
    {/dede:arclist}
</ul>

Breakdown of this example:

• {dede:arclist row='10' ...}: Sets the list to a maximum of 10 articles.len='30'`: Limits the title to 30 characters to prevent layout issues.
• orderby='pubdate': Sorts the articles by their publication date. Other common values are id, click (for most clicked), and hot (for hottest).
• orderway='desc': Sets the sort order to descending (newest first). Use asc for ascending (oldest first).
• [field:pubdate ...]: Displays the article's publication date. We use a function (MyDate) to format it nicely.
• [field:arcurl/]: Generates the full URL to the article's detail page.
• [field:title/]: Displays the article's title.

Commonly Used Attributes with arclist

Often, you'll use row along with other attributes to fine-tune your list.

Practical Use Cases

Use Case 1: Show 5 Articles from a Specific Category

Let's say you have a category "News" with ID=5. You want to show the 5 latest articles from just that category.

<h3>Latest News</h3>
<ul>
    {dede:arclist row='5' typeid='5' titlelen='25'}
    <li><a href="[field:arcurl/]">[field:title/]</a></li>
    {/dede:arclist}
</ul>

Use Case 2: Show 10 Most Clicked Articles from All Categories

To create a "Popular Articles" widget, you sort by the click count.

<h3>Popular Articles</h3>
<ol>
    {dede:arclist row='10' orderby='click' orderway='desc'}
    <li><a href="[field:arcurl/]" title="[field:title function='html2text(@me)'/]">[field:title/]</a></li>
    {/dede:arclist}
</ol>

Use Case 3: Show 10 Articles with Images (Flag 'p')

To get articles that have a thumbnail, you can use the flag attribute.

<div class="image-gallery">
    {dede:arclist row='10' flag='p' orderby='pubdate' orderway='desc'}
    <div class="item">
        <a href="[field:arcurl/]">
            <img src="[field:litpic/]" alt="[field:title function='html2text(@me)'/]">
            <span>[field:title/]</span>
        </a>
    </div>
    {/dede:arclist}
</div>

Troubleshooting

• Why are no articles showing?

  1. typeid is wrong: Double-check the ID of your category. You can find category IDs in DedeCMS's backend under "Content" -> "Category Management".
  2. No articles in the category: Make sure the category you are querying actually has articles in it.
  3. Template Caching: Sometimes, changes don't appear immediately due to template caching. Try clearing the cache in DedeCMS's backend under "System" -> "Clear Cache".

• Why are more than 10 articles showing?

  • You might have another arclist tag on the same page that is pulling more articles. Check your entire template file. The row attribute is specific to each individual {dede:arclist} tag.