Showroom

Randomelements :: Blog

Please send us an e-mail at tips@wsssearch.com if you'd like to add your sites to our Showroom list.

Since we posted manual instructions, we received many feedbacks on automating the manual steps. We wrote an installer program, DeploySPTagging.exe, to automate the old steps. The new instruction shows you how to use this program. For reference, we put the old instruction under the "Instructions without DeploySPTagging.exe" section.

Instruction with DeploySPTagging.exe:          

• Running the installer program

0. Download our zip file (WSSSearchWebParts.zip) and expand all files to a folder (e.g. C:\WSSSearchWebParts
0. Open a command prompt
0. Run the following command from the downloaded folder, DeploySPTagging SITENAME LISTNAME, where the SITENAME is your site's URL and LISTNAME is the list you want to add a "tags" metadata. e.g.

           C:\WSSSearchWebParts> DeploySPTagging http://wsssearch Announcements

This command will configure the web.config, copy files to the correst locations, register the web parts, and create a new metadata for the Announcement list. If you want to add the metadata column to other list, please run the command again with the different list name. Once the program completes, you should see no errors in the log. These two messages will be written on the console output:

           New SharePoint Tagging Web Parts is installed.

           New SharePoint Tagging Web Parts is activated.

• Import the Tag Cloud into a web part page of your site 

0. Open a command prompt Open a Web Part Page on your server, e.g. Home
0. Select Edit Page from the Site Actions menu in the upper right corner of the page, and click Add a Web Part in one of the zones.
0. In the Add Web Parts dialog box, click Advanced Web Part gallery and options in the lower right corner.
0. In the Add Web Parts pane, click Import.
0. Browse to the location of the TagCloud.dwp file at the downloaded folder, and then click the Upload button. After uploading, the page will refresh, and "Tag Cloud" should be displayed under Imported Web Part.
0. Drag the icon next to "Tag Cloud" to a zone on the Web Part Page.
0. Click "x" to close the "Add Web Parts" dialog box.
0. Click "Exit Edit Mode" to confirm the change.
0. Browse to the web page you just added the web part and see if it renders correctly with no errors. Now you should see the title of the web part only, because the site does not have the tags data.

• Testing the Web Part

0. Please create a new item and type "wsssearch" in the Tags field. Click OK.
0. Go back to the home page, you should see "Wsssearch" in the TagCloud tag cloud. You will be redirected to /tags.aspx page when you click on the tag. This page is a pre-configured web part pages with the tag browser and tag cloud web parts.
0. Enoy tagging!

Instructions without DeploySPTagging.exe:

• Deploying the Tag Cloud Web Part - adding the web part to see the semantic map of your site (screenshots coming soon)

0. Copy our Web Part’s assembly (here) to the C:\Inetpub\wwwroot\wss\VirtualDirectories\PORT\bin folder of your SharePoint site, where PORT is the port of your site, e.g. C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin
0. Register your Web Part as a safe control:
   0. Open the web.config file at C:\Inetpub\wwwroot\wss\VirtualDirectories\PORT\web.config, where PORT is the port of your site, e.g. C:\Inetpub\wwwroot\wss\VirtualDirectories\80\web.config.
   0. Add the following lines in the <SafeControls> block:                           <SafeControl Assembly="WSSSearchWebParts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=fd98c7c413b27ce6" Namespace="WSSSearchWebParts" TypeName="*" Safe="True" />
0. To allow custom web parts using the SharePoint Object Model, increase the trust level in Windows SharePoint Services from minimal (default) to medium by opening the web.config file at Local_Drive:\Inetpub\wwwroot and replacing the following line:  <trust level="WSS_Minimal" originUrl="" /> with the following:  <trust level="WSS_Medium" originUrl="" />
0. Reset Microsoft Internet Information Services (IIS) for changes in trust level to take effect.
0. Download the Tag Cloud Web Part Definition file (SPTagCloud.dwp)
0. Import the web part into a web part page of your site.
   0. Open a Web Part Page on your server, e.g. Home
   0. Select Edit Page from the Site Actions menu in the upper right corner of the page, and click Add a Web Part in one of the zones.
   0. In the Add Web Parts dialog box, click Advanced Web Part gallery and options in the lower right corner.
   0. In the Add Web Parts pane, click Import.
   0. Browse to the location of the TagCloud.dwp file, and then click the Upload button. After uploading, the page will refresh, and "Tag Cloud" should be displayed under Imported Web Part.
   0. Drag the icon next to "Tag Cloud" to a zone on the Web Part Page.
   0. Click "x" to close the "Add Web Parts" dialog box
0. Click "Exit Edit Mode" to confirm the change.
0. Browse to the web page you just added the web part and see if it renders correctly with no errors. Now you should see the title of the web part only, because the site does not have the tags data. The next step will show you how to add additional field(metadata) to your exiting lists in your WSS site.

• Add Tags Column to WSS lists - the Tag Cloud web part can automatically pull tag data from the columns

0. Go to the Home page and click on Site Actions
0. Select Site Setting
0. Under Gallaries column, click on Site Columns
0. Click “Create”
0. Enter “Tags” in the Column Name fields
0. Select “Single line of text”
0. Enter "Please use , as the delimiter between keyword tags" in the Description field
0. Click OK
0. By doing the above steps, the "Tags" column can be reused.
0. Go to any lists you want to add the new tags column, e.g. Annoucement
0. Go to the Announcement list from the homepage.
0. In the list page, click on Setting and select List Setting
0. Under Columns section, click on"Add from existing site columns"
0. Select Custom Columns and select Tags, and click Add.
0. The “Tags” column is moved to the right-hand side. Click OK.
0. The list will show the new Tags column
0. When creating/editing items, the form will show the Tags field.
0. To test the tag cloud web part, please create a new item and type "wsssearch" in the Tags field. Click OK.
0. Go back to the home page, you should see "Wsssearch" in the TagCloud tag cloud. You will see an "404 not found" error when you click on the tag. It's because you haven't created a page for listing items tagged with the tag. Please follow the next step to create a page for the tag browser

• Create a new page for tags browser - links in the Tag Cloud web part is redirected to the tag browser web par

0. Go back to Home
0. Click on Site Actions
0. Click on Create and select "Web Part Page"
0. Please enter “tags” into the Title and URL name field
0. Select "Header, right column, body" layout
0. Go with the default value "Shared Documents" for the document library
0. Click OK
0. A page at http://PORTALURL/Shared Documents/Tags.aspx will be created
0. You will see the page in edit mode, please follow the instruction below to deploy the tag browser web parts

• Deploying the Tag Browser web part to the new page - the Tag Browser web part shows the titles and URLs of items with tags

0. Download the Tag Browser web part (SPTagBrowser.dwp)
0. Go to the new page for tags browser you created in the previous steps.
0. Import the web part into the page
   0. Click Add a Web Part in one of the zones, e.g. body
   0. In the Add Web Parts dialog box, click Advanced Web Part gallery and options in the lower right corner.
   0. In the Add Web Parts pane, click Import.
   0. Browse to the location of the TagBrowser.dwp file, and then click the Upload button. After uploading, the page will refresh, and "Tag Browser" should be displayed under Imported Web Part.
   0. Drag the icon next to "Tag Browser" to a zone on the page
   0. Click "x" to close the "Add Web Parts" dialog box.
   0. You should see "No tags specified in the query". It's expected
0. Click "Exit Edit Mode" to confirm the change.
0. Please copy the part of the current URL after the PORTALNAME up to the question ? mark.
0. e.g. http://wsssearch.com/Shared%20Documents/tags.aspx?PageView=Shared.
0. Go back to the home page
0. Click on down arrow of the Tag Cloud web parts
0. Click on "Modify Shared Web Part"
0. Expand the Tagging Setting section
0. Make sure if the text displayed in the TagPageURL field is correct, e.g. "/Shared%20Documents/tags.aspx" or the landing URL of your tags page. If not, please paste the URL to the TagPageURL field.
0. Click OK. The links on the tag cloud will forward to the page
0. To test it, please go back to the home page.
0. Click on the tag in the tag cloud web part
0. It should redirect to the new page you just created and add the "?tags=TAG_NAME" to the url. The tag browser should show the title and url of list item with the tag TAG_NAME.
0. You are done with web parts deploying. You can add the Tags column to any lists you want. The tag cloud web part automatically put data from every Tags column.

If seeing any bugs or having any questions/comments, please do not hesitate to send us an e-mail at tips@wsssearch.com. We will upgrade the code after hearing your feedbacks.

This work is licensed under a Creative Commons Attribution-ShareAlike 2.5  License.