Kurogo Tutorial 11 - News Module -

이번에는 Kurogo의 News Module 을 살펴봐야겠네요. 관련된 일을 받았거든요.

News Module

뉴스 모듈은 RSS feed 로부터 받은 stories/articles 리스트를 보여 줍니다. 그 feed 가 full textual content를 제공한다면 그 article은 모바일에 맞는 포맷으로 유저에게 보여질 겁니다. 만약 그 feed가 full text를 담고 있지 않다면 그 article로 지정된 URL로부터 content를 fetch 하도록 configure 될 수 있습니다. (아래 FETCH_CONTENT 를 보세요.)

General Options

SITE_DIR/config/news/module.ini  안에 뉴스 모듈의 기본 작동에 관해 configure 할 수 있는 몇개의 옵션이 있습니다.

• MAX_RESULTS (10) - 뉴스 리스트에 보여질 아이템의 갯수 
• SHARING_ENABLED (1) - news entries에 sharing link를 걸 수 있는지 없는지 지정. 0으로 하면 지정할 수 없도록 함

Configuring News Feeds

news 모듈을 사용하기 위해 우선 여러분의 data로 연결하는 connection을 setup 해야 합니다. 이를 위해서는 2가지를 반드시 세팅해야 합니다.  이 작업을 하기 위해 Administration Module 를 이용하거나 SITE_DIR/config/news/feeds.ini file 에서 곧바로 값을 수정하시면 됩니다.

이 모듈은 multiple feeds를 지원합니다. 각 feed 는 configuration file안의 section에 의해 지정됩니다. 그 section의 이름은 0-indexed number 이어야 합니다 (i.e. 첫번째 feed는 0 이고 두번째 feed 는 1 ...). 아래의 값들이 필요합니다.

• TITLE 값은 여러분 feed 의 이름을 가르킵니다. 이 이름은 feed를 선택하기 위해 drop down list 했을 때 보여지게 됩니다.
  
• BASE_URL은 여러분의 News feed의 url을 세팅하면 됩니다. static file이 될 수도 있고 Web service 가 될 수도 있습니다.

Optional values

• RETRIEVER_CLASS - data를 get 하기 위해 alternate data retriever  를 세팅할 수 있도록 합니다. 디폴트는 URLDataRetriever 입니다.
  
• PARSER_CLASS - DataParser의 subclass로 세팅합니다. 여러분의 데이터 소스가 RSS/Atom 이나 RDF가 아닌 포맷으로 return 될 때에만 바꾸시면 됩니다. 디폴트는 RSSDataParser 입니다.
  
• SHOW_IMAGES - feed의 thumbnail 이미지를 보여줍니다. 이미지가 없으면 placeholder image 가 보일 겁니다. 만약에 모든 feed가 이미지를 가지고 있지 않으면 SHOW_IMAGES=0 으로 세팅하실 수 있습니다.
  
• SHOW_PUBDATE - 뉴스 리스트에 publish date를 보여 줌. (published date는 detail page에서는 항상 보여 짐)
• SHOW_AUTHOR - 뉴스리스트에 저자를 보여 줌 (detail page에서는 항상 저자를 보여 줌) 
• SHOW_LINK - full article에 대한 link를 보여 줌. feed에 introductory paragraph 만을 포함하고 있을 때 유용함. 

Additional Configuration for RSS Feeds

특정 RSS feeds에 대한 옵션들이 있습니다. RSSDataParser 가 디폴트 parser 이면 이것은 대부분의 feed들에 적용이 될 겁니다.

• CHANNEL_CLASS   RSS channel 에 대해 다른 클래스 이름을 세팅할 수 있도록 해 줌. 여러분은 custom subclass를 생성해서 unique하게 RSS 아이템을 핸들링 할 수 있습니다. 흔히 사용되지는 않습니다.
  
• ITEM_CLASS  feed 안에서 각 아이템에 대해 다른 클래스 이름을 세팅할 수 있도록 함. custom matter 안에 custom fields 나 parse fields를 가지고 있는 feed 를 핸들링 할 수 있도록 해 줍니다.
  
• ENCLOSURE_CLASS enclosures에 다른 클래스 이름을 세팅할 수 있도록 해 줍니다. enclosures에 대해 custom behavior를 핸들링 할 수 있도록 해 줍니다. 
• IMAGE_ENCLOSURE_CLASS  image enclosures에 대해 다른 클래스 이름을 세팅할 수 있도록 해 줍니다. 이미지에 대해 custom behavior를 핸들링 할 수 있도록 해 줍니다.
  
• REMOVE_DUPLICATES - feed에서 duplicate entry 들을 remove 합니다. (i.e. 같은 GUID를 가지고 있는 아이템).
  
• HTML_ESCAPED_CDATA - 1로 세팅하면 content와 description field 에 있는 HTML을 decode 할 겁니다. CDATA block에 wrapping 하기 위해 HTML data를 encode 하면서 feed가 HTML data를 encode 하는데 문제가 생길 경우 on으로 설정할 필요가 있습니다.
  
• USE_DESCRIPTION_FOR_CONTENT - 1로 세팅 돼 있으면 description field는 full content로서 사용될 겁니다.
  
• FETCH_CONTENT - 1로 세팅되면 Kurogo는 아이템에서 명시된 URL에서 content를 fetch 하는 것을 시도할 겁니다. 그리고 그 content를 extract 할 겁니다.