단편 웨이파인더 MODx에 대한 링크 목록을 구성하는 역할을 합니다. 우리 사이트의 메뉴는 그러한 링크의 목록입니다. 먼저 메뉴 표시를 담당하는 코드를 찾아보겠습니다. 메뉴는 덩어리로 헤더, 여기있어:

이 코드를 잘라내고 대신 작성해 보겠습니다.

((메뉴))

코드를 새 청크에 붙여넣습니다. 메뉴, 우리가 쓰는 청크의 설명에서 사이트 메뉴. 이제 이 코드를 살펴보겠습니다.

당사 웹사이트 메뉴는 다음이 포함된 컨테이너에 포함된 단순하고 정렬되지 않은 목록입니다. id="템플릿모_메뉴". 컨테이너에서 이 목록을 잘라내고 대신 스니펫 호출을 삽입해 보겠습니다.

&startId=`0`처리된 문서가 있는 폴더의 ID를 스니펫에 알려주는 값이 0인 매개변수입니다. 메뉴에 표시할 모든 문서는 루트 폴더에 있으며 루트 폴더 ID는 0입니다. 우리가 무엇을 얻었는지 봅시다.

메뉴가 작동 중이며 활성 항목만 더 이상 흰색으로 강조 표시되지 않습니다.

왜 이런 일이 일어났는지 이해하려면 다음을 살펴봐야 합니다. 원천페이지. 에 모질라 파이어 폭스다음과 같이 수행됩니다. 보기 >> 페이지 소스 코드또는 바로 가기 키를 눌러 Ctrl+U. 메뉴 코드를 찾습니다.

소스 코드에서 활성 항목이 클래스="현재", 그리고 우리의 스니펫은 자동으로 활성 항목에 할당됩니다. 클래스="활성". 또한 소스 코드에서 클래스가 태그에 적용된 순간을 알 수 있습니다. 이제 태그로

Wayfinder에 대한 호출에서 추가 &rowTpl=`부모` .
소스 코드를 확인하는 것을 잊지 마십시오. 거의 모든 것이 정상이며 하위 메뉴가 남아 있습니다.

하위 메뉴를 설정하기 위해 innerRowTpl 변수를 사용합니다.

청크 생성 안의:

Wayfinder 호출에 변수 추가 innerRowTpl=`내부`및 하위 메뉴 컨테이너에 대한 클래스를 지정하는 변수 &innerClass=`하위` .

Wayfinder에 대한 최종 호출은 다음과 같습니다.

그게 다야, 우리 메뉴가 준비되었습니다. 행운을 빕니다!

독자 여러분 안녕하십니까. 지난 수업에서 사이트를 일부 콘텐츠()로 채웠습니다. 이제 메뉴에 모든 것을 담다사용자가 탐색할 수 있도록 합니다.

동적으로 만들다 MODX의 메뉴우리는 스 니펫을 사용할 것입니다 PdoMenu패키지에서 pdo도구. 시작하기 전에 기본 문서를 읽으십시오.

pdoMenu 문서

옵션

템플릿 옵션

CSS 클래스 옵션

공식 예

공식 문서여기에서 읽을 수 있습니다. 이제 가장 일반적인 메뉴 호출을 분석합니다.

전화하기 PdoMenu

옵션 1. 이 정적 메뉴 대신 pdoMenu 스니펫 호출, 이를 위해 리소스 트리의 " 집단” 스니펫 섹션에서 분기를 확장합니다. pdo도구을 클릭한 다음 pdo메뉴마우스 왼쪽 버튼(버튼에서 손을 떼지 않음)을 누르고 이 스니펫을 메뉴를 호출하려는 위치로 드래그한 다음 열리는 창에서 필요한 매개변수를 채우고 " 구하다«.

옵션 2. 우리는 도전 과제를 수동으로 작성합니다.

대표적인 예

일반 단일 레벨 메뉴

예를 들어 다음 html 마크업이 있는 가장 일반적인 메뉴가 있습니다.

결과는 메뉴 호출이 있는 다음 코드입니다.

• &parents=`0` - 부모 목록(내 경우에는 특정 페이지만 표시하므로 선택을 제한하지 않음);
• &level=`1` - 중첩 수준(이 경우에는 존재하지 않음);
• &resources=`2,3,4,5` - 메뉴에 표시할 리소스 목록;
• &firstClass=`0` - 첫 번째 메뉴 항목에 대한 클래스(어떤 항목이 아님);
• &lastClass=`0` — 클래스 마지막 포인트메뉴(무엇이 아님);
• &outerClass=`top-menu` — 메뉴 래퍼 클래스(ul로 대체됨);
• &hereClass=`current-menu-item` - 활성 메뉴 항목의 클래스(li로 대체됨);
• &rowClass=`menu-item` - 단일 메뉴 모음의 클래스(li로 대체됨).

2단계 사용자 정의 부트스트랩 메뉴

정적 html 코드는 다음과 같습니다.

출력 코드는 다음과 같습니다.

또한 다음 강의에서는 부트스트랩을 기반으로 하는 드롭다운 메뉴의 출력을 몇 개 더 제공할 것입니다.

언뜻보기에는 모든 것이 복잡해 보이지만 그렇지 않습니다. 자세한 내용은 설명서를 읽고 의견에 질문하십시오. 확실히 도움이 될 것입니다.

메뉴 생성 스니펫. Wayfinder를 대체할 수 있으며 매개변수를 지정할 때 더 많은 유연성을 허용합니다.

예를 들어, 한 번에 여러 부모로부터 메뉴를 만들어 함께 표시하거나 별도의 분기로 표시할 수 있습니다.

처음 시작할 때만 속도가 크게 증가한 다음 유능한 캐싱 덕분에 Wayfinder가 특히 열등하지 않습니다.

옵션

기본적으로 pdoMenu는 일반적인 pdoTools 옵션과 자체 옵션을 허용합니다.

템플릿 옵션

이 옵션은 메뉴 생성을 위한 템플릿이 포함된 청크를 설정합니다.

CSS 클래스 옵션

이 매개변수는 자리 표시자 [[+classnames]] 및 [[+classes]] 값을 설정합니다. 다양한 요소메뉴. [[+classnames]] 자리 표시자는 속성 없이 클래스 이름만 표시합니다. 클래스="", [[+classes]] 자리 표시자와 대조됩니다.

예

사이트 루트에서 한 수준으로 메뉴의 일반적인 출력:

[]

특정 상위가 제외되고 사용자 권한이 확인된 출력:

[]

한 번에 두 부모의 메뉴 표시, 루트 포인트 표시:

[]

중첩 수를 계산하여 두 가지 수준의 리소스 표시:

[]` &tplParentRow=`@INLINE

• 목록, 표, 이미지, 아이콘 등의 형태의 메뉴
• 정적 메뉴
• 다양한 효과가 있는 메뉴(드롭다운, 드롭다운 등)
• 사이트의 지도

&rowTpl=`rowTpl`
&outerTpl=`outerTpl`
&hereClass=`활성`
&rowClass=`eNav_li`]]

스니펫 옵션:

시작 ID(&startId)- 상위 페이지의 id, 0을 지정하면 사이트의 루트에서 가져옵니다. 기본값은 활성 페이지의 ID입니다.

디스플레이 시작(&디스플레이) - 메뉴 제목에 startId가 있는 문서 표시, 기본적으로 false

&수준- 중첩 깊이, 기본값 0 - 모든 수준

&한계- 출력의 페이지 수 제한(기본값 0 - 제한 없음)

무시(&I)숨김- "메뉴에 표시" 페이지의 확인란을 무시합니다. 1을 지정하면 모든 페이지가 표시됩니다. 기본값은 0입니다. "메뉴에 표시" 확인란이 선택된 페이지만 표시됩니다.

&ph - 즉시 출력을 대체하는 대체 이름입니다. 기본값은 0입니다.

디버그(&D)- 디버그 모드(기본값 0)

&hideSubMenus - 활성 하위 메뉴만 확장(기본값 0)

새 줄 제거(&removeNewLines)- 출력에서 ​​줄 바꿈 문자를 제거합니다(기본값 0).

&textOfLinks- 메뉴 링크의 이름. 가능한 옵션:menutitle, id, pagetitle, description, parent, alias, longtitle, introtext . 기본메뉴 제목

&titleOfLinks- 메뉴 링크의 제목 옵션:menutitle, id, pagetitle, description, parent, alias, longtitle, introtext. 기본페이지 제목

행 ID 접두어(&rowIdPrefix)- 각 요소에 대한 id(rowIdPrefix + docId)를 설정합니다. 기본값 0

문서 포함(&include)- 메뉴에 포함될 문서의 ID(쉼표로 구분)(기본적으로 지정되지 않음)

문서 제외(&excludeDocs) - 메뉴에서 제외될 문서의 ID(쉼표로 구분)(기본값은 0)

컨텍스트(&context)- 메뉴 생성을 위한 컨텍스트. 기본값은 현재입니다.

&startIdContext - 결과를 형성하기 위해 문서를 가져오는 컨텍스트 식별자입니다.

구성(&config) - 외부 PHP 파일, Wayfinder 구성을 저장합니다(예: core/components/wayfinder/configs).

&계획 - URL을 생성하기 위한 형식입니다. 가능한 값(makeURL API 호출 기반):

1: (기본값) site_url에 상대적인 URL;

0: http 참조;

1: https 참조;

전체: site_url로 시작하는 절대 URL;

abs: base_url로 시작하는 절대 URL;

http: 절대 URL, http 체계에서 시행됨.

https: https 체계에서 시행되는 절대 URL입니다.

&정렬 기준 - 정렬 기준이 되는 필드입니다. (기본메뉴 인덱스)

옵션:

템플릿 예: [[+wf.linktext]][[+wf.wrapper]]

템플릿 옵션

이 옵션은 Wayfinder 출력을 생성할 패턴이 포함된 청크를 지정합니다.

에 현재 버전 MODX Revolution용 Wayfinder를 사용하면 wf 접두사 자리 표시자를 사용하여 맞춤형 TV에 액세스할 수 있습니다. , 예를 들어 [[+my_TV]]

작성 시 원래 TV 값만 반환되며 포맷되지 않습니다. 예를 들어 TV가 이미지인 경우 템플릿 내에서 이러한 TV를 일반적으로 사용하면 전체 이미지 태그가 반환되지만 Wayfinder 템플릿 내에서는 이미지 경로만 반환됩니다.

TV를 처리하려면 Wayfinder 행 템플릿(&rowTpl . 예를 들어, 이미지 TV는 상일반적으로 템플릿의 출력에 대해 다음 코드와 같은 것이 사용됩니다.

... ...

그러나 이렇게 하면 TV를 처리할 수 없으므로 다음으로 교체해야 합니다.

... ...

이제 processTV 스니펫 내부에 다음 PHP 코드를 배치합니다.

getObject("modResource", $myId); 반환 $doc->getTVValue($myTV);

결과적으로 완전히 처리된 TV 이미지가 반환됩니다.

&outerTpl

외부 컨테이너 템플릿을 포함하는 청크의 이름입니다.

사용 가능한 자리 표시자:

• wf.classes - Wayfinder 옵션 세트(class="" 포함) 속성에서 가져온 클래스를 표시합니다.
• wf.classnames - 클래스 이름 표시(class="" 제외)
• wf.wrapper - 내부 콘텐츠(행)의 출력.

[[+wf.래퍼]]

&innerTpl 매개변수에는 &outerTpl 과 동일한 자리 표시자 세트가 포함되어 있습니다.

&rowTpl

메뉴 행의 요소에 대한 템플릿을 포함하는 청크의 이름입니다.

사용 가능한 자리 표시자:

• wf.classes - 클래스 출력(class="" 포함) 속성
• wf.classnames - 해당 클래스의 출력(class="" 제외)
• wf.link - 메뉴 링크의 href="" 속성 값
• wf.title - &titleOfLinks 매개변수에 지정된 필드의 링크 제목 텍스트 이름
• wf.linktext - &textOfLinks 매개변수에 전달된 필드에 지정된 활성 링크의 텍스트
• wf.wrapper - 하위 메뉴와 같은 내부 콘텐츠 출력
• wf.id - 고유한 속성 ID를 출력합니다. 이 자리 표시자가 값을 가져오려면 &rowIdPrefix 매개변수를 지정해야 합니다. 값은 접두사 + docId입니다.
• wf.attributes - 현재 요소에 대한 속성 참조를 표시합니다.
• wf.docid - 현재 요소의 문서 ID
• wf.description - 현재 요소에 대한 설명
• wf.level - 현재 중첩 수준

사용 예:

[[+wf.linktext]][[+wf.wrapper]]

다른 옵션:

예

첫 번째 수준

outerTpl 청크 코드

[[+wf.래퍼]]

rowTpl 청크 코드

[[+wf.래퍼]]

두 번째 수준(이 예에서 메뉴와 하위 메뉴 항목은 시각적으로 동일한 수준에 있었습니다.

[[!웨이파인더? &startId=`0` &level=`2`
&rowTpl=`rowTplFooterMenu`
&outerTpl=`outerTplFooterMenu`
&innerTpl=`innerTplFooterMenu`
&innerRowTpl=`innerRowTplFooterMenu`
&hereClass=`활성`]]

OuterTplFooterMenu 청크 코드

rowTplFooterMenu 청크 코드

• 
  
  [[+wf.제목]]
  
  

[[+wf.래퍼]]

innerTplFooterMenu 청크 코드

[[+wf.래퍼]]

innerRowTplFooterMenu 청크 코드