Sitecore Space - 사이트코어

2016년 9월 28일 수요일

Sitecore Query.MaxItems - 제한된 Query 늘이기

이전에 Dynamic Placeholder를 사용하는법에 대하여 포스트를 한적이 있다.

Placeholder는 컨텐츠를 제한되어진 범위내에 사용할수있도록 해주어, 사용자가 컨텐츠를 손쉽게 업데이트할수 있도록 유용하게 쓰인다.

하지만, 큰 프로젝트를 작업하는데 있어서 많은 Placeholder Setting Item이 필요하고, 이것을 일일히 템플릿 Layout에 적용할때는 상당한 시간이 걸린다. Sitecore는 Query Performance를 최소화하기 위하여 한번에 Sitecore Query API를 리딩할수있는 아이템을 수 (Query.MaxItems)를 "100"으로 제한해두며, 해당 정보는 Placeholder Cache에 저장한다. 이로 인하여, Placeholder Setting Item의 수가 100 이상이면, 해당 Request는 Placeholder Cache에 저장하지 않는다.

sitecore.config 파일에서 `<setting name="Query.MaxItems" value="100"/>`의 value 값을 변경하면 쉽게 문제를 해결할수가 있다.

해당 Placeholder에 렌더링 아이템을 추가해 놓았지만, 등록된 아이템을 볼수가 없다.

Value 값을 "1000"으로 업데이트 한 후, 등록되어진 아이템을 Placeholder에서 볼수가 있다.

1	<setting name="Query.MaxItems" value="1000"/>

Rendering Item 정보 가져오기

새로운 Rendering 아이템을 만들다 보면, 페이지 아이템에 적용되어져있는 Control을 찾아야 하는경우가 있다. 이럴경우 Fast Query 또는 LINQ를 통하여 레이아웃에 적용되어진 모든 Rendering 아이템 정보를 가져올수가 있다.

// 현재 페이지에 적용되어진 모든 렌더링 아이템 가져오기
IEnumerable<RenderingReference> renderings = Context.Item.Visualization.GetRenderings(Context.Device, false);
               
// 해당 렌더링 아이템 아이디를 사용하고 있는 모든 렌더링 아이템 정보 가져오기
renderings = renderings.Where(x => x.RenderingID == RenderingContext.Current.Rendering.RenderingItem.ID);
               
// 해당 Placeholder에 사용되고 있는 모든 렌더링 아이템정보 가져오기
renderings = renderings.Where(x => x.Placeholder.TrimStart('/') == RenderingContext.Current.Rendering.Placeholder.TrimStart('/'));

// 현재 렌더링아이템의 인덱스 값 가져오기
var index = renderings.ToList().FindIndex(x => new Guid(x.UniqueId) == RenderingContext.Current.Rendering.UniqueId);

2016년 9월 5일 월요일

사이트코어 - Chrome Extension - URL Replacement for Sitecore

사이트코어를 사용하다보면, 현재 Publish 되어진 사이트(페이지)와 사이트코어 페이지 아이템을 비교해야할 경우가 생긴다. 그럴경우, Content Editor의 Quick Info 섹션을 통하여 아이템 경로를 확인한 후, 새로운 창 또는 윈도우를 오픈하여 해야 해당 페이지 아이템을 라이브 URL 경로르 입력해야한다.

물론, 사이트코어의 .config 파일 설정을 통하여 "Preview" 를 클릭하였을시 "Web" DB를 포인팅하도록 할수는 있지만, Front-End Developer의 입장에서는 시스템 또는 사이트코어 관리자에게 설정을 요청하여야 한다. 물론, 설정하는 것에는 어려움이 없으나, .config 파일의 설정은 사이트코어 시스템 전체에 적용이 되므로, 결정을 내리는데 있어서는 약간 까다로운(?) 부분이 있다.

이런 불편함을 덜어내기 위하여 최근에 "URL Replacement"라는 Chrome Extension을 만들었다. 사용법 및 설명은YouTube 또는 Option 설정페이지에 있으므로, 참고할 수 있다.

Chrome Extension: https://goo.gl/BMiVjZ
YouTube: https://www.youtube.com/watch?v=klrIlpiZJdk

2016년 7월 31일 일요일

사이트코어에 새로운 아이콘 추가하기

#Icon #NewIcon #사이트코어 #아이콘

이번에는 Sitecore 아이콘에 대하여 설명하여 보겠다.

사이트코어에서 아이템의 타입을 쉬게 표시하기 위하여, 아이콘을 사용한다. Content Editor 상단의 툴바에서 "Configuration" 탭을 선택하면, Icon 메뉴가 있다. Icon 메뉴를 선택하면 최근 사용한 Icon 목록과 카테코리별로 나눠져있는 Icon리스트를 볼수있다.

Applications
Business
Controls
Core 1
Core 2
Core 3
Database
Flags
Imaging
Multimedia
Network
Other
People
Software
Word Processing

사이트코어는 기본적으로 .config 파일에서 "UseZippedIcons"을 "true" 세팅이 되어져있어, "/WebSite/Sitecore/Shell/Themes/Standard" ZIP file 형식으로 카테고리별로 저장이 되어있다. 만약, 새로운 아이템을 추가하고 싶다면 해당 카테고리를 unzip 하고, 새로운 아이콘을 사이즈별로 저장을 한다.

16x16
24x24
32x32
48x48
128x128

기본적인 아이콘의 경로는 "/ZipFileName/Size/IconName.png" 이다.

2016년 6월 8일 수요일

EXM - 새로 추가되어진 리스트의 잠겨진 상태

#Sitecore #사이트코어 #EXM

Sitecore에서 EXM (Email Experience Manager)를 통하여 이메일 캠페인을 만들수가 있다. EXM를 설치 후, 새로운 컨택트 리스트를 추가하다보면 아래처럼 "현재 리스트가 잠겨져있어, 모든정보가 업데이트될때까지 현재 리스트를 사용할수 없습니다." 라고 메세지가 나온다. 현재 추가된 리스트를 보면 "Status"란에 "Building"이라는 상태를 볼수있는데, 이것은 Sitecore가 새로운 리스트를 데이타베이스에 만들고 있다는 것이고, 약 15분에서 30분 (시스템 및 네트워크에 따라 틀림) 기다리다보면, 자동적으로 "Building" 상태가 없어진것을 볼수가 있다.

- Sitecore 8.0에서 EXM 3.0버전으로 테스트함.

Hyperlink Manager의 URL경로 가져오기

#사이트코어 #RichTextEditor #Telerik

RichText 에디터를 사용하다보면, Telerik을 통하여 Hyperlink를 설정할수가 있다. 이 경우, 해당 URL 필드에 미디어 파일을 선택할수가 있는데, 미디어를 선택하고 나면, 아이템의 Physical file경로가 아닌 "/~/media/[ShortID].ashx"로 변경된다. 물론, 이 세팅은 .config 파일에서 변경이 가능하지만, 시스템적으로 고유의 ID를 통하여 파일을 렌더링하는것이 더 효율적이다라고 할수있다.

GetMediaURI 과 GetItemURL 메서드를 이용하여, 파일의 경로를 찾아낼수있지만, 추가적으로 선택된어진 아이템의 "/~/media/" + item.ID.ToShortID() + ".ashx" 형식으로 정보를 가져와야하므로, 번거로움이 있다. 이럴경우, `MediaUrlOptions()`를 통하여 URL필드의 값을 쉽게 가져올수가 있다.

var mPath = new MediaUrlOptions();

// UseItemPath는 아이템을 경로를 통하여 나타낼것인지, 
// 아니면 아이디를 통하여 나타낼것인지 미리 설정을 할수가 있다.
mPath.UseItemPath = false;

var url = Sitecore.Resources.Media.MediaManager.GetMediaUrl(imageField.MediaItem, mPath);

2016년 5월 20일 금요일

Placeholder Setting 없이 다이나믹한 Placeholder 사용하기

#사이트코어 #Placeholder #Dynamic

템플릿을 만들고 "__Standard Values" 아이템을 만들어 레이아웃 및 컨트롤을 정의해놓으면, 손 쉽게 페이지를 만들고 설정할수가 있다.

페이지 View (.cshtml)에는 이미 정해진 Placeholder Key 값이 있고, 여기에 Assign이 된 렌더링 아이템들만이 Dynamic하게 사용되어질수 있는데, 하나 추가적으로 세팅해야 할것은 템플릿 또는 페이지 레이아웃의 Placeholder Settings에 꼭 이 Key 값을 추가해야지 Placeholder가 수정되어질수있다. 여기 "Placeholder Setting" 리스트를 추가하지 않으면, 페이지에 등록된 Placeholder는 사용할수가없다.

만약, 한 페이지에 다양하고 많은 Placeholder값이 필요하다면, 이것을 하나하나 추가하기는 쉽지가 않을뿐더러, 새로운 Placeholder를 추가해야한다면 또 레이아웃을 수정 해야하므로 번거로움이 많다.

사이트 .config 파일에서 이것을 쉽게 Disable 할수가 있다.

"Sitecore.ExperienceEditor.config" 파일에서 "WebEdit.PlaceholdersEditableWithoutSettings"을 "true"로 변경하면, Placeholder Settings 없이 다이나믹한 Placeholder를 사용할수가 있다.

<!-- 
    WEB EDIT PLACEHOLDERS EDITABLE WITHOUT SETTINGS Indicates 
    whether placeholders should be editable in the Page Editor 
    if placeholder settings are not specified. 
    Default value: false 
--> 

<setting name="WebEdit.PlaceholdersEditableWithoutSettings" value="true" />