This page describes Sueetie Global List View Controls, giving you the ability to view application data from anywhere on a Sueetie Community.
What are Global List View Controls
Global List View Controls are lists containing application-generated community content. The lists can be generated based on ApplicationID, GroupID, UserID, Media Type, Most Recent, or in combination. Supported application lists include:
- Blog Posts
- Blog Comments
- Forum Topics
- Forum Messages
- All Media Types
- Wiki Pages
- User Activity Logs
- Sueetie Blog RSS Feeds
List View Controls can be placed anywhere on a Sueetie Community, enabling you to display, say, photos from a media gallery or latest posts from a blog.
Examples of List View Controls
Here are a few examples of Sueetie Global List View Controls in action. First is the Recent Blogs List View Control on an earlier
Sueetie.com Home Page which retrieves the latest blog posts from all community blogs.
The second example is on the
Sueetie.com Public Demo Group Home Page where most recent topics of that group's forum are displayed.
The third is an example of Global List View Control is the display of Multiple Site Blogs.
image||http://sueetie.com/x/site/2010/listviews0512c.jpg]
Common Logic for All Sueetie List View Controls
All Sueetie List View Controls share a common architecture and properties, so when you learn how to use one you know how to use them all. Let's look at the file logic.
The List View Control that you drop onto a web page and which you specify properties for display are located in /controls/ directory (in blue) while the actual view HTML file you style to include various content elements is located in /themes/THEME/views (in red.)
A word about content access and the IsRestricted property. Sueetie applications (like YetAnotherForum.NET) have their own access logic based on ASPNET Role Membership. In regards to Sueetie List View Controls, content is either accessible to everyone or to site administrators. This is performed by assigning the IsRestricted flag in the Sueetie_Content table to TRUE for any content originating in any restricted area, like a restricted forum, for instance.
When you drop a List View Control onto a web page you have a number of properties you can configure. Below is an example using the Most Recent Blog Post List View Control on the Sueetie.com Home Page.
The View file in your Themes/THEME/Views directory is where you specify exactly how you want the view to look. Here is the Themes/THEME/Views/RecentBlogPostView.ascx file. You can see that it supports full Intellisense to provide you with all of the available properties of the enhanced SueetieBlogPost data object.
Using the Blog RSS Feed List View Control
The Blog RSS Feed List View Control enables you to display any Sueetie Blog RSS Feed (that is, any BlogEngine.NET-based feed) anywhere simply by providing the feed's url in the FeedUrl property of the control. Here's what that looks like.
Below is an example of using the Blog RSS Feed List View Control, as the latest Sueetie Blog feed is displayed on the Administration Home Page.
Using List View Controls Across Multiple Applications
Most of what we've been talking about so far was using List View Controls in the Sueetie Framework, outside of any particular application like YetAnotherForum.NET, Gallery Server Pro, etc. With Sueetie v3.2, List View Controls can now be used anywhere, in any application. You can now drop in a Photo List View Control in a blog, for example. An demonstration of using List View Controls in any application can be seen on the Sueetie.com footer, where the Recent User Activity and Blog Post List View Controls are displayed for all pages on all applications.
Cross-application usage of List View Controls follows the same pattern of specifying the control and view stated earlier.
The List View Control that you drop onto a web page and which you specify properties for display are located in /controls/ directory (in blue) while the actual view HTML file you style to include various content elements is located in /themes/THEME/views (in red.)
.NET Applications require User Controls to be located in the same application, so the only difference is that the /Controls and /Views are found within the application's theme structure. For Review, here are the Controls/Views locations for the framework areas:
Home Page, CMS, Marketplace, Search, Login, etc
Controls are located in /Controls/.
Views are located in /themes/CURRENT_THEME/Views.
Here are the Controls/Views locations for the various Sueetie Applications to employ List View Controls across multiple applications.
Blogs, Forums, Wiki
Controls are located in /APP/themes/CURRENT_THEME/Controls.
Views are located in /APP/themes/CURRENT_THEME/Views.
Media Gallery
Controls are located in /APP/gs/styles/CURRENT_THEME/Controls.
Views are located in /APP/gs/styles/CURRENT_THEME/Views.
Note: Controls can be located anywhere within the application, but views must exist in the locations specified. Controls are located in the Current_Theme/Controls folder for consistency across the applications and to maintain separation between Sueetie Logic and Application Logic.
Here's a screenshot of a BlogEngine.NET blog directory layout with the locations of the /Controls and /Views contents in the /Themes/CURRENT_THEME location as described.
Top